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提要 


Pythonjé — fh fg PEAS , TT AR 动态 数据 类 
型 的 高 级 程序 设计 语言 。 通 过 Python 编程 ， 我 们 能 
够 解决 现实 生活 中 的 很 多 任务 。 


本 书 通过 14 个 有 趣 的 项 目 ， 帮 助 和 或 励 恋 者 探 
索 Python 编 程 的 世界 。 全 书 共 14 章 ， 分 别 介 绍 了 通 
过 Python 编程 实现 的 一 些 有 趣 项 目 ， 包 括 解 析 
iTunes 播 放 列 表 、 模 拟人 工 生 命 、 创 建 ASCII 码 艺 
术 图 、 照 片 拼 接 、 生 成 三 维 立 体 图 、 创 建 粒 子 模 拟 
的 烟花 喷 录 效果 、 实 现 立 体 光 线 投射 算法 ， 以 及 用 
python 结合 Arduino 和 树 每 派 等 硬件 的 电子 项 目 。 本 
书 并 不 介绍 Python 语言 的 基础 知识 ， 而 是 通过 一 系 
列 不 简单 的 项 目 ， 展 示 如 何 用 Python 来 解决 各 种 实 
际 问 题 ， 以 及 如 何 使 用 一 些 流行 的 Python 库 。 


本 书 适 合 那 些 想 要 通过 Python 编 程 来 进行 尝试 
和 探索 的 读者 ， 适 合 了 解 基本 的 Python 语 法 和 基本 
的 编程 概念 的 读者 进一步 学 习 ， 对 于 Python 程 序 员 
有 一 定 的 局 发 和 参考 价值 。 
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欢迎 阅读 本 书 ! 在 本 书 中 ， 你 会 看 到 14 个 令 人 





兴奋 的 项 目 ， 旨 在 或 励 你 探索 Python 编程 的 世界 。 


这 些 项 目 涉 及 广泛 的 主题 ， 如 绘制 类 似 万 花 尺 的 花 
纹 、 生 成 ASCII 码 艺术 图 、3D 泻 染 ， 以 及 根据 音乐 
同步 投射 激光 图 像 。 除 了 本 喘 很 有 趣 之 外 ， 这 些 项 
目的 意图 是 提供 一 些 起 点 ， 让 你 通过 扩展 每 个 项 
目 ， 来 探索 你 自己 的 想法 。 








本 书 的 目标 读者 





本 书 的 目标 读者 ， 是 所 有 想 知 道 如 何 利 用 编程 
来 理解 和 探索 想法 的 人 。 本 书 的 项 目 假设 你 了 解 基 
本 的 Python 语 法 和 基本 的 编程 概 仿 ， 并 假设 你 熟 迁 
局 中 数学 知识 。 我 已 经 尽 了 最 大 的 努力 ， 评 细 解 释 
了 上 所 有 项 目 中 需要 的 数学 知识 。 


本 书 不 会 是 你 的 第 一 本 Python 书 。 我 不 会 指导 
你 学 习 基 本 知识 。 但 我 会 通过 一 系列 不 简单 的 项 
目 ， 向 你 展示 如 何 用 Python 来 解决 各 种 实际 问题 。 
在 学 习 这 些 项 目 时 ， 你 将 探索 Python 编程 语言 的 细 
WER, FAS ante eA ERT Python. {A 
也 许 更 重要 的 是 ， 你 将 学 习 如 何 将 问题 分 解 成 几 个 
部 分 ， 开 发 一 个 算法 来 解决 这 个 问题 ， 然 后 从 头 用 
Python 来 实现 一 个 解决 方案 。 解 决 现实 世界 的 问题 
可 能 很 难 ， 因 为 它们 往往 是 开放 式 的 ， 并 且 需 要 各 
个 领域 的 专业 知识 。 但 Python 提供 了 一 些 工 具 ， 协 
助 解决 问题 。 元 服 困难 ， 和 寻找 实 际 问题 的 解决 方 
案 ， 这 是 成 为 专家 级 程序 员 的 旅途 中 最 重要 的 环 
"s 


























本 书 的 内 容 


让 我 们 快速 浏览 一 下 本 书 各 章 的 内 容 。 
第 一 部 分 : 热 吴 运动 


第 1 章 展 示 了 如 何 解析 iTunes 播 放 列 表 文件 ， 
并 从 中 收集 有 用 的 信息 ， 如 音 轨 长 度 和 共同 的 音 
轨 。 在 第 2 章 中 ， 我 们 使 用 参数 方程 及 海鱼 作 图 
法 ， 绘 制 类 似 万 花 尺 产生 的 那些 曲线 。 


Moor : 模拟 生命 


部 分 是 用 数学 模型 来 模拟 现象 。 在 第 3 章 
中 ， 我 们 将 学 习 如 何 实现 Conway 游 戏 的 生命 游戏 
算法 ， 产 生动 态 的 模式 来 创建 其 他 模式 ， 以 模拟 一 
种 人 工 生 命 。 第 4 章 展示 了 如 何 用 Karplus-Strong 算 
FORGE ANSE. Aa, FESTA, Ri] 
Er Mem WAS AER, BAUS AR RRIT 
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部 分 介绍 使 用 Python 读 取 和 操作 2D 网 像 。 
ERG. 了 如 何 根据 图 像 创建 ASCII 码 艺术 图 。 


7 章 中 ， 我 们 将 进行 照 厂 拼接 。 在 第 8 半 中 ， 我 们 将 
学习 如 何 生成 三 维 立 体 图 ， 它 让 人 产生 3D 图 像 的 销 
Ju 
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第 四 部 分 : 走 进 三 维 


这 一 部 分 的 项 目 使 用 OpenGEL 的 3D 图 形 库 。 第 
9 章 介 绍 使 用 OpenGL 创 建 简 单 3D 图 形 的 基本 知识 。 
在 第 10 间 中， 我 们 将 创建 粒子 模拟 的 烟花 顺 果 ， 它 
用 数学 和 OpenGL 着 色 右 来 计算 和 泻 染 。 在 第 11 章 
中 ， 我 们 将 使 用 OpenGL 着 色 器 来 实现 立体 光线 投 
冉 算 法 ， 来 演 染 立体 数据 ， 该 技术 常用 于 医疗 影 
像 ， 如 MRI 和 CT 扫描 。 


第 五 部 分 : 玩 转 便 件 


在 最 后 一 部 分 中 ， 我 们 将 用 Python 来 探索 
Arduino 微 控制 器 和 树 每 派 。 在 第 12 草 中， 我们 将 
利用 Arduino， 通 过 一 个 简单 电路 读 取 并 标 绘 传 感 
器 数据 。 在 第 13 章 中 ， 我 们 将 利用 Python 和 Arduino 
来 控制 两 个 旋转 锐 和 激光 恬 ， 生 成 啊 应 声音 的 激光 
俘 。 在 第 14 章 中 ， 我 们 将 使 用 树 生 派 打造 一 个 基于 
网 络 的 气象 监测 系统 。 














为 何 选 择 Python 


Python 是 探索 编程 的 理想 语言 。 作 为 一 种 多 范 
式 语 言 ， 在 如 何 组 织 程序 方面 ， 它 提供 了 极 大 的 灵 
活性 。 你 可 以 将 Python 视 为 脚本 语言 ， 简 单 地 执行 
代码 ， 或 将 其 视 为 过 程 语言 ， 把 程序 组 织 成 一 组 彼 
此 调用 的 函数 ， 或 将 其 视 为 面 回 对 象 语 言 ， 利 用 
类 、 继 承 和 模块 来 建立 层次 结构 。 这 种 灵活 性 让 你 
可 以 选择 最 适合 特定 项 目的 编程 风格 。 


如 采用 更 传统 的 语言 来 开 有 友 ， 如 C 或 C ++， 你 
必须 先 编译 和 链接 代码 ， 然 后 才能 运行 它 。 使 用 
Python， 你 可 以 编辑 后 直接 运行 它 〈 在 背后 ， 
Python 将 你 的 代码 编译 成 中 间 字 节 人 码 ， 然 后 由 
Python 解 释 器 运行 ， 但 这 些 过 程 对 用 户 是 透明 
的 ) 。 在 实践 中 ， 用 Python 多 次 修改 并 运行 代码 ， 
要 容易 很 多 。 


此 外 ，Python 解 释 占 是 非 第 方便 的 工具 ， 可 用 
于 检查 代码 语法 ， 获 得 模块 的 帮助 ， 进 行 快速 计 
T AMAA AS. Bilan, R Python 
代码 时 ， 会 打开 三 个 窗口 : 文本 编辑 器 、 命 令 行 和 
Python 解释 左 。 我 在 编辑 磺 中 写 代 码 时 ， 会 在 解释 
aH PAF ES, ARIMA 





























Python 有 一 组 非常 小 、 和 人 简 单 而 强大 的 数据 结 
构 。 如 果 你 理解 了 字符 串 、 列 表 、 元 组 、 字 典 、 列 
表 解 析 和 基本 控制 结构 ， 如 for 和 while 循 环 ， 那 么 
你 已 经 开 了 个 好 头 。 Python 简洁 而 有 表现 力 的 语 
法 ， 使 得 我 们 很 容易 只 用 几 行 代码 ， 就 完成 复杂 的 
操作 。 而 一 旦 熟悉 Python 内 置 的 模块 和 第 三 方 模 
块 ， 你 将 拥有 大 量 的 工具 ， 用 于 解决 真正 的 问题 ， 
就 像 本 书 中 介绍 的 那样 。 从 Python 中 调用 C/C++ 代 
人 码 有 标准 的 方式 ， 反 之 亦 然 。 因 为 在 Python 中 可 以 
找到 库 来 做 几乎 所 有 事情 ， 我 们 很 容易 在 大 型 项 目 
中 组 合 使 用 Python 和 其 他 语言 模块 。 这 就 是 为 什么 
Python 被 认为 是 了 不 起 的 胶水 语言 ， 它 可 以 很 容易 
地 组 合 使 用 不 同 的 软件 组 件 。 本 书 最 后 的 硬件 项 目 
展示 了 Python 如 何 与 Arduino 和 JavaScript 代 人 三 协 
作 。 真 实 的 软件 项 目 经 和 常 使 用 多 种 软件 技术 ， 
Python 非常 适合 这 种 分 层 体 系 结构 。 

下 面 的 例子 展示 了 Python 的 易 用 性 。 在 第 14 章 
中 为 树 答 派 天 气 监控 器 开 发 代码 时 ， 我 看 着 温度 / 湿 
度 传 感 右 的 示波器 输出 ， 写 下 这 一 串 数 字 : 




















0011011100000000000110100000000001010001 


因为 我 不 能 用 二 进 制 讲 话 ， 所 以 局 动 了 Python 
解释 卉 并 输入 : 


>>> str = '0011011100000000000110100000000001010001' 
>>> len(str) 
40 


>>> [int(str[i:i+8], 2) for i in range(0, 40, 8)] 
[55, 0, 26, 0, 81] 


这 行 代码 将 40 位 字符 串 切 分 转换 成 5 个 8 位 的 整 
数 ， 这 是 我 可 以 理解 的 。 上 述 数 据 被 解释 为 55.0% 
的 湿度 ， 瘟 度 为 26.0 摄 氏 上 度 ， 校 验 和 是 55 + 26 = 
81. 


这 个 例子 展示 了 如 何 实际 使 用 Python 解释 器 作 
为 非常 强大 的 计算 器 。 你 不 必 写 一 个 完整 的 程序 束 
能 快速 计算 ， 只 要 打开 解释 器 ， 就 可 以 开始 。 这 只 
是 我 走 欢 Python 的 一 个 原因 ， 原 因 还 有 很 多 ， 上 所 以 
我 认为 你 也 会 喜欢 Python。 


Python 的 版 本 


本 书 基 于 Python 3.3.3， 但 所 有 代码 都 与 Python 
2.7.x43.x3f Ro 


ZKBB 

在 本 书 中 ， 我 尽 了 最 大 的 努力 引导 你 详细 研究 
每 个 项 目的 人 代码， 一段 接 一 段 地 进行 。 你 可 以 目 己 
输入 代码 ， 或 从 https://github.com/electronut/pp/ 或 


www.epubit. com.cn 下 载 书 中 所 有 程序 的 完整 源 代 
码 〈 单 击 Download Zip) 。 

















接 下 来 ， 你 会 看 到 一 些 令 人 兴奋 的 项 目 。 我 希 
望 你 玩 这 些 项 目 时 ， 圣 受 的 乐趣 和 我 创造 它们 时 一 
MS MEA sic, AA BES Ae R He EAN 
练习 进一步 探索 。 我 希望 你 和 本 书 一 起 度 过 许多 快 
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“在 初学 者 的 头脑 中 有 很 多 可 能 性 ， 
在 专家 的 头脑 中 ， 可 能 性 很 少 。” 
铃木 俊 隆 











Ale ” 解 机 iTunes 播放 列表 





我 们 的 Python 探险 始 于 一 个 简单 的 项 目 ， 该 项 
目 在 iTunes 播 放 列 表 文 件 中 碍 找 重 复 的 乐曲 音 轨 ， 





并 绘制 各 种 统计 数据 ， 如 音 轨 长 度 和 评分 。 你 可 以 
从 碍 看 iTunes 播 放 列表 格式 开始 ， 然 后 学 习 如 何 用 
Python 提取 这 些 文 件 的 信息 。 为 了 绘制 这 些 数 据 ， 
要 用 到 matplotlib 库 。 


在 这 个 项 目 中 ， 我 们 将 学 习 以 下 主题 : 


。XML 和 属性 列表 Cp-list) 文件 ; 
。Python 列 表 和 字典 ; 

。 使 用 Python 的 set 对象; 

。 使 用 numpy 数 组 ，; 

。 直 方 图 和 散 点 图 ; 

。 用 matplotlib 库 绘制 简单 的 图 ; 

。 创 建 和 保存 数据 文件 。 


1.1 iTunes 播放 列表 文件 训 析 





iTunes 资 料 库 中 的 信息 可 以 导出 为 播放 列表 文 
TF CfEiTunes'P i 4% File > Library» Export 
Playlist) 。 播 放 列表 文件 以 可 扩展 标记 语言 
(XML) 写成 ， 这 是 一 种 基于 文本 的 语言 ， 旨 在 分 
层 表 示 基 十 义 本 的 信息 。 它 包 括 一 些 用 户 定 义 的 标 
答 所 构成 的 树 状 集合 ， 标 签 形 如 <MyTag>， 每 个 标 
侈 可 以 有 一 些 属 性 和 子 标签 其 中 包含 附加 的 信 


人 J 已 vo 











如 采 在 文本 编辑 器 中 打开 一 个 播放 列表 文件 ， 
你 会 看 到 类 似 这 样 的 简化 版 本 : 


«?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE plist PUBLIC 

//Apple Computer//DTD PLIST 1.0//EN" "http://www 

apple.com/DTDs/PropertyList-1.0.dtd"> 

 «plist version="1.0"> 

@ «dict» 

@ <key>Major Version</key><integer>1</integer> 
<key>Minor Version</key><integer>1</integer> 
--snip-- 

® <key>Tracks</key> 
<dict> 

<key>2438</key> 
<dict> 
<key>Track ID</key><integer>2438</integer> 
<key>Name</key><string>Yesterday</string> 
<key>Artist</key><string>The Beatles</string> 
<key>Composer</key> 
<string>Lennon [John], McCartney [Paul]</string> 


<key>Album</key><string>Help!</string> 
</dict> 
--snip-- 
</dict> 
<key>Playlists</key> 
<array> 
<dict> 
<key>Name</key><string>Now</string> 
<key>Playlist ID</key><integer>21348</integer> 
--snip-- 
<array> 
<dict> 
<key>Track ID</key> 
<integer>6382</integer> 
</dict> 
--snip-- 
</array> 
</dict> 
</array> 
</dict> 
</plist> 





属性 列表 CP-list) 文件 将 对 象 表示 为 字典 ， 
«dict» 和 «key» 标签 与 这 种 方式 有 关 。 字 — 典 是 把 键 
和 值 天 联 起 来 的 数据 结构 ， 让 查找 值 变 得 容易 。 属 
性 列表 文件 使 用 字典 的 字典 ， 其 中 和 键 关 联 的 值 往 
往 目 身 又 是 另 一 个 词典 《甚至 一 个 字典 列表 ) 。 


<Xml> 标 签 确 定 文件 为 XML 文件 。 在 这 个 开始 
标签 之 后 ， 文 档 类 型 定义 (DTD) 定义 了 XML 文档 
的 结构 @。 如 你 所 见 ， 侠 果 在 该 标签 中 的 统一 资源 
定位 符 CURL) 中 定义 了 这 种 结构 。 


在 信行 ， 文 件 声明 了 顶层 <plist> 标 签 ， 其 唯一 
子 元 素 是 字典 <dict> ©. ZFRAD AH Æ 

















他 行 ， 包 括 Major Version, Minor Version， 等 等 ， 
但 我 们 的 兴趣 在 和 人行 的 Tracks 键 。 注 意 ， 该 键 对 应 
的 值 也 是 一 个 字典 ， 它 将 整数 的 音 轨 ID 映射 到 另 一 
个 字典 ， 其 中 包含 Name、Artist 等 元 叉 。 音 乐 收 藏 
中 的 每 个 音 轨 都 有 唯一 的 音 轨 ID 键 。 


播放 列表 顺序 在 @@ 行 由 Playlists 定 义 ， 它 是 顶 
层 字 — 典 的 一 个 子 节 点 。 


12 ”所 需 模 块 


在 这 个 项 目 中 ， 我 们 用 内 置 模块 plistlib 来 读 取 
播放 列表 文件 。 我 们 还 用 matplotlib 库 来 绘图 ， 用 
numpy 的 数组 来 存储 数据 。 


1.3 代码 








该 项 目的 目标 是 找到 你 的 音乐 收藏 中 的 重复 乐 
曲 ， 确 定 播放 列表 之 间 共 同 的 音 轨 ， 绘 制 音 轨 时 长 
的 分 布 图 ， 以 及 歌曲 评分 和 时 长 之 间 的 天 系 图 。 


随 看 首 乐 收藏 不 断 增加 ， 你 总 会 遇 到 重复 的 乐 
曲 。 为 了 确定 重复 的 乐曲 ， 但 找 与 Tracks 键 关联 的 
字典 中 的 名 称 〈 前 面 讨论 过 〉 ， 找 到 重复 的 乐曲 ， 
并 用 音 轨 长 度 作 为 附加 准则 来 检 训 重复 的 乐曲 ， 
oo 但 长 度 不 同 的 首 轨 ， 可 能 是 不 一 样 











要 找到 两 个 或 多 个 播放 列表 之 间 共 同 的 音 轨 ， 
你 需要 将 音乐 收藏 导出 为 播放 列表 文件 ， 收 集 每 个 
播放 列表 的 音 轨 和 名称， 作为 集合 进行 比较 ， 通 过 发 
现 集合 的 交集 来 找到 共同 的 音 轨 。 


在 收集 音乐 收藏 数据 的 同时 ， 我 们 将 使 用 强大 
的 matplotlib (http://matplotlib.org/〉 绘 图 软件 包 来 
创建 一 些 图 ， 访 软件 包 由 已 故 的 John Hunter 开 发 。 
我 们 可 以 绘制 直方 图 来 显示 音 轨 时 长 的 分 布 ， 绘 制 
散 点 图 来 比较 乐曲 评分 与 长 度 。 


要 奏 看 完整 的 项 目 代 码 ， 请 直接 跳 到 1.4 他 。 








131 查找 重复 


首先 可 以 用 findDuplicates() 方 法 来 查找 重复 的 
曲目 ， 如 下 所 示 : 





def findDuplicates(fileName): 
print('Finding duplicate tracks in %...' % fileName) 
# read in a playlist 


e plist - plistlib.readPlist(fileName) 
# get the tracks from the Tracks dictionary 
(2) tracks = plist['Tracks'] 
# create a track name dictionary 
e trackNames = {} 
# iterate through the tracks 
o for trackId, track in tracks.items(): 
try: 
O name = track['Name'] 
duration = track['Total Time'] 
# look for existing entries 
Q if name in trackNames: 
# if a name and duration match, increment th 
# round the track length to the nearest seco 
if duration//1000 -- trackNames [name] 
[0]//1000: 
count - trackNames [name] [1] 
e trackNames[name] = (duration, count+1) 
else: 
add dictionary entry as tuple (duration, c 
© trackNames[name] = (duration, 1) 
except: 
# ignore 
pass 


在 @ 行 ，readPlist() 方 法 接受 一 个 p-list 文 件 作 
| 并 返回 顶层 字典 。 在 信行 ， 访 问 Tracks 字 
典 ， 在 信行 ， 创 建 一 个 空 的 字典 ， 用 来 保存 重复 的 


乐曲 。 在 @@ 行 ， 开 始 用 items0) 方 法 迭代 Tracks 字 
典 ， 这 是 Python 在 迭代 字典 时 取得 键 和 值 的 常用 方 
12s 


在 @ 行 ， 取 得 字典 中 每 个 首 轨 的 名 称 和 时 长 。 
用 in 关 键 字 ， 检 查 当 前 乐曲 的 名 称 是 否 已 在 被 构建 
的 字典 中 人 @。 如 果 是 这 样 的 ， 程 序 检 查 现 有 的 首 轨 
和 新 发 现 的 单轨 长 度 是 否 相 同人 @， 用 // 操 作 符 ， 将 
每 个 音 轨 长 上 度 除 以 1000， 由 一 秒 转换 为 秒 ， 并 四 人 铭 
五 入 到 最 接近 的 秒 ， 以 进行 检查 〈 当 然 ， 这 意味 
着 ， 只 有 曲 秒 差异 的 两 个 音 轨 被 认为 是 相同 的 ) 。 
如 果 确 定 这 两 个 首 轨 长 度 相等 ， 束 取得 与 Iame 关 联 
的 值 ， 这 是 (duration, count) 元 组 ， 并 在 全 行 增 
加 计数 。 如 果 这 是 程序 第 一 次 过 到 的 首 轨 名 称 ， 整 
创建 一 个 新 条 有 目 ，count 为 1@， 

将 代码 的 主 for 循 环 放 在 try 语 句 块 中 ， 这 是 因 
为 一 些 乐 曲 音 轨 可 能 没有 定义 乐曲 名 称 。 在 这 种 情 
况 下 ， 跳 过 该 音 轨 ， 在 except 部 分 只 包含 pass〈 什 
么 也 不 做 ) 。 
1.3.2 ERER 


利用 以 下 代码 ， 提 取 重 复 的 音 轨 : 









































# store duplicates as (name, count) tuples 
e dups - [] 
for k, v in trackNames.items(): 
if v[1] > 1: 


dups.append((v[1], k)) 
# save duplicates to a file 
if len(dups) > 0: 


print("Found %d duplicates. Track names saved to dup 
else: 
print("No duplicate tracks found!") 
f = open("dups.txt", "w") 
for val in dups: 
f.write("[%d] %s\n" % (val[0], val[1])) 
f.close() 


在 @ 行 ， 创 建 一 个 空 列表 ， 保 存 重复 乐曲 。 接 


FR, ikfURjtrackNames EJ, Ap count (用 
v[1] 访 问 ， 因 为 它 是 元 组 的 第 二 个 元 素 ) 大 于 1@， 
则 将 元 组 (name，count) 添加 到 列表 中 ， fre 
行 ， 程 序 打 印 它 找到 的 信息 ， a... 
信息 存 入 文件 四 .在 回 行 ， 迭 代 遍 历 dups 列 表 ， 写 








下 重复 的 条 目 。 
133 ”查找 多 个 播放 列表 中 共同 的 音 轨 





现在 ， 让 我 们 来 看 看 如 何 找到 多 个 播放 列表 中 


共同 的 乐曲 音 轨 : 


e 


e 
e 


def findCommonTracks(fileNames): 


# a list of sets of track names 
trackNameSets - [] 
for fileName in fileNames: 
4 create a new set 
trackNames - set() 
# read in playlist 
plist - plistlib.readPlist(fileName) 
# get the tracks 
tracks - plist['Tracks'] 


# iterate through the tracks 
for trackId, track in tracks.items(): 
try: 
# add the track name to a set 
o trackNames.add(track[ 'Name']) 
except: 
# ignore 
pass 
# add to list 
® trackNameSets.append(trackNames) 
# get the set of common tracks 
Q commonTracks = set.intersection(*trackNameSets) 
# write to file 
if len(commonTracks) » 0: 


(7) f = open("common.txt", "w") 
for val in commonTracks: 
s = "%s\n" % val 
e f.write(s.encode("UTF-8")) 
f.close() 


print("%d common tracks found. " 
"Track names written to common.txt." % len(com 


else: 
print("No common tracks!") 


首先 ， 将 播放 列表 的 文件 名 列表 传 入 
findCommonTracks()， 它 创建 一 个 空 列 表 @， 保 存 
从 每 个 播放 列表 创建 的 一 组 对 象 。 然 后 程序 迭代 通 
历 列表 中 的 每 个 文件 。 对 每 个 文件 ， 创 建 一 个 名 为 
trackNames 的 Python seb] RO, MS RE 
findDuplicates() 中 一 样 ， 用 plistlib 读 入 文件 人 @， 取 
得 Tracks 字 典 。 接 下 来 ， 迭 代表 历 该 字典 中 的 每 个 
音 轨 ， 并 添加 trackNames 对 象 例 。 程 序 读 完 一 个 文 
件 中 的 所 有 音 轨 后 ， 将 这 个 集合 加 入 
trackNameSets@. 











在 @ 行 ， 使 用 set.intersection() 方 法 来 获得 集合 
之 间 共 同音 轨 的 集合 〈 用 Python* 的 运算 符 来 展开 
参数 列表 ) 。 如 果 程 序 发 现 集合 之 间 的 共同 首 轨 ， 
束 将 首 轨 名 称 写 入 一 个 文件 。 在 @ 行 ， 打 开 文 件 ， 
接 下 来 的 两 行 代码 完 成 写 入 。 使 用 encode() 来 格式 
化 输出 ， 确 保 所 有 Unicode 字 符 都 正确 处 理 全 。 


1.3.4 收集 Zt TE TH Jus 


接 下 来 ， 用 plotStats0) 方 法 ， 针 对 这 些 音 轨 和 名 
称 收集 统计 信息 : 











def plotStats(fileName): 
# read in a playlist 
e plist - plistlib.readPlist(fileName) 
# get the tracks from the playlist 
tracks - plist['Tracks'] 
# create lists of song ratings and track durations 
(2) ratings = [] 
durations = [] 
# iterate through the tracks 
for trackId, track in tracks.items(): 
try: 
e ratings.append(track['Album Rating']) 
durations.append(track['Total Time']) 
except: 
# ignore 
pass 


# ensure that valid data was collected 
@ if ratings == [] or durations == []: 


print("No valid Album Rating/Total Time data in %s." 
return 


这 里 的 目标 是 收集 评分 和 音 轨 时 长 ， 然 后 男 一 
些 图 。 在 四 行 和 接 下 来 的 代码 行 中 ， 读 取 了 播放 列 
表 文 件 ， 并 访问 Tracks 字 典 。 接 下 来 ， 创 建 两 个 空 
列表 ， 保 存 评 分 和 时 长 人 (在 iTunes 播 放 列 表 中 ， 
评分 是 一 个 整数 ， 苑 围 是 [0，100]) . KEN Er 
轨 ， 在 候 行 ， 将 评分 和 时 长 添加 到 相应 的 列表 中 。 
最 后 ， 在 人 @ 行 检查 完整 性 ， 确 保 从 播放 列表 文件 收 
集 了 有 效 数 据 。 


1.3.5 ”绘制 数据 
我 们 已 准备 好 绘制 一 些 数 据 了 。 





# scatter plot 

x = np.array(durations, np.int32) 

# convert to minutes 

x = x/60000.0 

y = np.array(ratings, np.int32) 
pyplot.subplot(2, 1, 1 

pyplot.plot(x, y, 'o') 

pyplot.axis([0, 1.05*np.max(x), -1, 110]) 
pyplot.xlabel('Track duration' ) 
pyplot.ylabel('Track rating' ) 


ooococoo © 


# plot histogram 
pyplot.subplot(2, 1, 2) 
pyplot.hist(x, bins=20) 
pyplot.xlabel('Track duration' ) 
pyplot.ylabel('Count') 


© 


# show plot 
D pyplot.show() 


在 @ 行 ， 利 用 numpy.array()〔 在 代码 中 作为 np 


导入 ) ， 将 音 轨 时 长 数据 放 到 32 位 整数 数组 中 。 然 
后 在 信行 ， 利 用 numpy， 将 一 个 操作 应 用 于 数组 中 
的 每 个 元 际 。 在 这 个 例子 中 ， 将 每 个 以 坚 秒 为 单位 
的 时 长 值 除 以 值 60x1000。 在 @ 行 ， 将 乐曲 评分 保 
存 另 一 个 numpy 数 组 y 中 。 


用 matplotlib 在 同一 图 像 上 绘制 两 张 图 。 在 人 @ 
行 ， 提 供给 subplot() 的 参数 〈 即 ，(2， 1, 1) 告诉 
matplotlib， 该 图 应 该 有 两 行 (2) 一 列 a), HF 
一 个 点 应 在 第 一 行 CD 。 在 @ 行 ， 通 过 调用 plot( 
创建 一 个 点 ， 并 且 o 告 诉 matplotlib 用 圆圈 来 表示 数 
据 。 


在 @@ 行 ， 为 x 轴 和 y 轴 设置 略微 大 一 点 儿 的 范 
用 ， 以 便 在 图 和 轴 之 间 留 一 些 空间 。 在 @ 和 全 行 ， 
为 x 轴 和 y 轴 设置 说 明文 字 。 


现在 用 matplotlib 的 方法 hist()， 在 同一 张 图 中 
的 第 二 行 中 ， 绘 制 时 长 直方 图 @@。bins 参 数 设置 了 
数据 分 区 的 个 数 ， 其 中 每 分 区 用 于 这 加 在 这 个 范围 
内 的 计数 。 最 后 ， 调 用 show0 电 ，matplotlib 在 新 窗 
口中 显示 出 漂亮 的 图 。 


1.3.6 ”命令 行 选 项 


现在 ， 我 们 来 看 看 该 程序 的 main() 方 法 如 何 处 
理 命令 行 参数 : 








def main(): 
# create parser 
descStr = """ 


This program analyzes playlist files (.xml) exported fro 


e parser = argparse.ArgumentParser(description=descStr) 
# add a mutually exclusive group of arguments 
(2) group = parser.add_mutually_exclusive_group() 


# add expected arguments 
group.add argument('-- 
common', nargs='*', dest-'plFiles', required-False) 
group.add argument('-- 
stats', dest-'plFile', required-False) 
group.add argument('-- 
dup', dest-'plFileD', required-False) 


# parse args 
Q args - parser.parse args() 


if args.plFiles: 
# find common tracks 
findCommonTracks(args.plFiles) 
elif args.plFile: 
# plot stats 
plotStats(args.plFile) 
elif args.plFileD: 
# find duplicate tracks 
findDuplicates(args.plFileD) 
else: 
print("These are not the tracks you are looking fo 


本 书 的 大 多 数 项 目 都 有 命令 行 参数 。 不 要 尝试 
手工 分 析 它 们 并 搞 得 一 团 糟 ， 要 将 这 个 日 第 的 任务 
委派 给 Python 的 argparse 模 块 。 在 @ 行 ， 为 此 创建 了 
一 个 ArgumentParser 对 象 。 访 程序 可 以 做 三 件 不 同 
的 事情 ， 如 发 现 播 放 列 表 之 间 的 共同 音 轨 ， 绘 制 统 
计数 据 ， 或 有 友 现 播放 列表 中 重复 的 曲目 。 但 是 ， 一 





个 时 间 程 序 只 能 做 其 中 一 件 事 ， 如 果 用 户 决 定 同 时 
指定 两 个 或 多 个 选项 ， 我 们 不 希望 它 朋 省 。 
argparse 模 块 为 这 个 问题 提供 了 一 个 解决 方案 ， 即 
相互 排 奈 的 参数 分 组 。 在 信行 ， 用 
parser.add_mutually_exclusive_group() 方 法 来 创建 这 
样 一 个 分 组 。 


在 合 、@ 和 人 @@ 行 ， 指 定 了 前 面 提 到 的 命令 行 选 
项 ， 并 输入 应 该 将 解析 值 存 入 的 变量 名 
Cargs.plFiles, args.plFilefllargs.plFileD) ， 实 际 解 
析 在 @@ 行 完成 。 参 数 解析 后 ， 就 将 它们 传递 给 相应 
的 函数 ，findCommonTracksO、PplotStatsO 和 
findDuplicates()， 本 章 前 面 讨论 过 这 些 函 数 。 
要 人 查看 参数 是 否 锌 解析 ， 束 测试 args 中 相应 的 
变量 名 。 例 如 ， 如 果 用 户 没 有 使 用 --common 选 项 
(该 选项 找 出 播放 列表 之 间 的 共同 首 轨 ) ， 解 析 后 
args.plFiles 应 该 设置 为 None。 


在 @ 行 ， 人 处理 用 户 未 输入 任何 参数 的 情况 。 














1.4 完整 代码 


下 面 是 完整 的 程序 。 在 
https://github.com/electronut/pp/tree/master/playlist/, 
你 也 可 以 找到 本 项 目的 代码 和 一 些 测 试 数 据 。 


import re, argparse 

import sys 

from matplotlib import pyplot 
import plistlib 

import numpy as np 


def findCommonTracks(fileNames): 
WW 
Find common tracks in given playlist files, 
and save them to common.txt. 
# a list of sets of track names 
trackNameSets - [] 
for fileName in fileNames: 
# create a new set 
trackNames - set() 
# read in playlist 
plist - plistlib.readPlist(fileName) 
# get the tracks 
tracks - plist['Tracks'] 
# iterate through the tracks 
for trackId, track in tracks.items(): 
try: 
# add the track name to a set 
trackNames.add(track['Name']) 
except: 
# ignore 
pass 
# add to list 
trackNameSets.append(trackNames) 
# get the set of common tracks 
commonTracks - set.intersection(*trackNameSets) 


def 


# write to file 

if len(commonTracks) » 0: 
f = open("common.txt", 'w') 
for val in commonTracks: 


s = "%s\n" 96 val 
f.write(s.encode("UTF-8")) 
f.close() 


print("%d common tracks found. " 
"Track names written to common.txt." % len( 
else: 
print("No common tracks!") 


plotStats(fileName): 


Plot some statistics by reading track information fro 
# read in a playlist 
plist - plistlib.readPlist(fileName) 
# get the tracks from the playlist 
tracks - plist['Tracks'] 
# create lists of song ratings and track durations 
ratings - [] 
durations - [] 
# iterate through the tracks 
for trackId, track in tracks.items(): 
try: 
ratings.append(track['Album Rating']) 
durations.append(track['Total Time']) 
except: 
# ignore 
pass 
# ensure that valid data was collected 
if ratings -- [] or durations -- []: 
print("No valid Album Rating/Total Time data in 96 
return 


# scatter plot 

x- np.array(durations, np.int32) 

# convert to minutes 

X = x/60000.0 

y - np.array(ratings, np.int32) 
pyplot.subplot(2, 1, 1) 

pyplot.plot(x, y, 0 ) 

pyplot.axis([0, 1.05*np.max(x), -1, 110]) 
pyplot.xlabel('Track duration!) 
pyplot.ylabel('Track rating!) 


# plot histogram 


pyplot.s 
pyplot.h 
pyplot.x 
pyplot.y 
# show p 
pyplot.s 


def findDupl 


Find dup 
print('F 
# read i 
plist = 
# get th 
tracks = 
# create 
trackNam 
# iterat 
for trac 
try: 


[0]//1000: 


ubplot(2, 1, 2) 

ist(x, bins-20) 
label('Track duration' ) 
label('Count') 

lot 

how( ) 


icates(fileName): 
licate tracks in given playlist. 


inding duplicate tracks in %...' % fileName) 
n playlist 
plistlib.readPlist(fileName) 
e tracks from the Tracks dictionary 
plist['Tracks'] 
a track name dictionary 
es = {} 
e through tracks 
kId, track in tracks.items(): 


name = track['Name' ] 
duration = track['Total Time' | 
# look for existing entries 
if name in trackNames: 
# if a name and duration match, increment 
# round the track length to the nearest s 
if duration//1000 == trackNames[name ] 


count = trackNames[name][1] 
trackNames[name] = (duration, count+1 
else: 
# add dictionary entry as tuple (duration 
trackNames[name] = (duration, 1) 


except: 


# store 
dups = [ 


# ignore 
pass 
duplicates as (name, count) tuples 


] 


for k, v in trackNames.items(): 
if v[1] > 1: 


# save d 

if len(d 
prin 

else: 
prin 


dups.append((v[1], k)) 

uplicates to a file 

ups) » 0: 

t("Found %d duplicates. Track names saved to 


t("No duplicate tracks found!") 


f = open("dups.txt", 'w') 


for val in dups: 
f.write("[%d] %s\n" % (val[0], val[1])) 
f.close() 


# gather our code in a main() function 

def main(): 
# create parser 
descStr = """ 
This program analyzes playlist files (.xml) exported 
parser = argparse.ArgumentParser(description=descStr) 
# add a mutually exclusive group of arguments 
group = parser.add_mutually_exclusive_group() 


# add expected arguments 
group.add argument('-- 
common', nargs-'*', dest-'plFiles', required-False) 
group.add argument('-- 
stats', dest-'plFile', required-False) 
group.add argument('-- 
dup', dest='plFileD', required-False) 


# parse args 
args - parser.parse args() 


if args.plFiles: 
# find common tracks 
findCommonTracks(args.plFiles) 
elif args.plFile: 
# plot stats 
plotStats(args.plFile) 
elif args.plFileD: 
# find duplicate tracks 
findDuplicates(args.plFileD) 
else: 
print("These are not the tracks you are looking for." 


# main method 
if _name__ == ' main ': 
main() 


1.5 运行 程序 


下 面 是 该 程序 的 运行 示例 : 


$ python playlist.py --common  test-data/maya.xml test- 
data/rating.xml 


下 面 是 输出 : 


5 common tracks found. Track names written to common.txt. 
$ cat common.txt 

God Shuffled His Feet 

Rubric 

Floe 

Stairway To Heaven 

Pi's Lullaby 

moksha:playlist mahesh$ 


现在 ， 让 我 们 绘制 这 些 普 轨 的 一 些 统计 数据 。 


$ python playlist.py --stats test-data/rating.xml 


图 1-1 展 示 了 这 次 运行 的 输出 。 





图 1-1 playlist.py 运 行 示例 


1.6 ”小结 


在 这 个 项 目 中 ， 我 们 开发 了 一 个 程序 ， 分 析 了 
iTunes 播 放 列 表 。 在 这 个 过 程 中 ， 我 们 学 习 了 一 些 
有 用 的 Python 结构 。 在 接 下 来 的 项 目 中 ， 你 将 基于 
这 里 介绍 的 一 些 基 础 知识 ， 探 索 各 种 有 趣 的 主题 ， 
深入 地 研究 Python。 





1.7 实验 


下 面 有 一 些 方法 可 以 扩展 这 个 程序 。 


1. 发 现 重 复 首 轨 时 ， 考 虑 了 以 首 轨 时 长 作为 
附加 标准 ， 来 确定 两 个 首 轨 是 否 相 同 。 但 寻找 共同 
的 音 轨 时 ， 只 用 了 音 轨 名 称 进 行 比较 。 在 
findCommonTracks() 中 ， 请 结合 首 轨 时 长 作为 额外 
的 检查 。 


2. 在 plotStats() 方 法 中 ， 用 了 matplotlib 的 hist() 
方法 来 计算 和 显示 柱状 图 。 请 编写 代码 手动 计算 直 
方 图 ， 不 用 histO) 方 法 显示 。 要 将 结果 显示 为 条 形 
图 ， 请 秽 读 matplotlib 文 档 中 条 形 图 的 部 分 。 


3. 有 一 些 数学 公 却 用 于 计算 相关 系数 ， 测 量 
两 个 变量 之 间 的 关系 强度 。 阅 读 相 关 性 的 资料 ， 利 
用 你 目 己 的 首 乐 数据 ， 计 算 评 分 /时 长 黎 扣 图 中 的 相 
天 系数 。 请 考虑 可 以 利用 播放 列表 中 收集 的 数据 ， 
制作 出 男 外 那些 散 操 图。 
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我 们 可 以 用 万 花 尺 玩具 〈 如 图 2-1 所 示 ) KA 





制 数 学 曲线 。 这 种 玩具 由 两 个 不 同 尺 寸 的 塑料 齿轮 


组 成 ， 一 大 一 小 。 小 的 齿轮 有 几 个 孔 。 把 钢笔 或 铬 
笔 放 入 一 个 也 ， 然 后 在 较 大 次 轮 (内 部 有 疮 〉 内 旋 
转 里 面 的 小 次 轮 ， 保 持 笔 与 外 轮 接触 ， 可 以 男 出 无 
BUR AR TI Ay WY HIRT AK ZR 


在 这 个 项 目 中 ， 我 们 将 用 Python 来 创建 动画 ， 
像 万 花 尺 一 样 绘制 曲线 。 我 们 的 Spiro.py 程 序 将 用 
Python 和 参数 方程 来 摘 述 程序 的 万 花 尺 齿轮 的 运 
动 ， 并 绘制 曲线 〈 我 称 之 为 螺 线 ) 。 我 们 可 以 将 完 
成 的 画图 保存 为 PNG 图 像 文 件 ， 并 用 命令 行 选项 来 
指定 参数 或 生成 随机 螺 线 。 


在 这 个 项 目 中 ， 我 们 将 学 习 如 何在 计算 机 上 绘 
PRR EOI UL BLA: 


。 用 turtle 模 块 创建 图 形 ; 

。 使 用 参数 方程 ; 

。 利 用 数学 方程 来 生成 曲线 ; 
。 用 线段 来 男 曲 线 ; 

。 用 定时 磊 来 生成 图 形 动画 ; 
。 将 图 形 保存 为 图 像 文 件 。 


E 
" 
4 
u 
" 
5 
4 
" 
" 





图 2-1 HÆR 


天 于 这 个 项 目 要 注意 : 我 在 这 个 项 目 中 选择 了 
turtle 模 块 用 于 说 明 展 示 ， 因 为 它 很 有 趣 ， 但 turtle 比 
较 慢 ， 如 果 性 能 很 关键 ， 束 不 适合 用 它 来 创建 图 形 

(你 对 海 包 有 何 期 望 ? ) 。 如 果 想 快速 画图 ， 有 更 
好 的 方法 ， 后 面 的 项 目 将 探索 一 些 可 选 方案 。 








21 参数 方程 





在 本 节 中 ， 你 将 看 到 用 参数 方程 来 男 圆 的 简单 
例子 。 参 数 方程 将 曲线 上 点 的 坐标 表示 为 一 个 变量 
的 函数 ， 该 变量 称 为 参数 。 参 数 方程 让 绘制 曲线 变 
得 容易 ， 因 为 只 要 将 参数 代入 方程 就 能 产生 曲线 。 


or 


v. 
YE 














如 琳 你 现在 不 想 学 习 这 部 分 数学 知识 ， 可 以 跳 到 下 一 部 分 ， 讨 
论 针 对 万 花 尺 项 目的 方程 。 


我 们 开始 考虑 用 半径 r 来 描述 一 个 圆 的 方程 ， 
圆心 位 于 二 维 平 面 的 原点 。x、y 坐 标 满 足 该 方程 的 
所 有 点 构成 了 圆 。 


现在 ， 请 考虑 下 和 面 的 方程 : 


x = r cos(0) 





y=rsin(@) 


这 些 方 程 是 圆 的 参数 表示 ， 其 中 角 6 是 参数 。 
这 些 方程 中 CX, YO 的 任何 值 ， 都 满足 前 面 描述 
的 圆 的 方程 ，X2< + Y?- R<。 如 果 让 6 从 0 变 到 2r， 可 
以 用 这 些 方程 来 计算 加 上 对 应 的 x 和 y 坐 标 。 图 2-2 展 











ZU 





x = rcos|6) 
y = rsin(6) 


图 2-2 ”用 参数 方程 描述 圆 


记 住 ， 这 两 个 方程 适用 于 圆心 在 坐标 系 原 点 的 
Al. WR Deal Aa, 入， 就 可 以 将 圆 置 于 xy 平面 
的 任何 位 置 。 所 以 更 一 般 的 参数 方程 就 变 成 x = a + 
r cos(0)flly = b + r cos(0)。 现 在 ， 让 我 们 来 看 看 描 
述 螺 线 的 方程 。 


211 万 花 尺 方程 
图 2-3 展 示 了 类 似 万 花 尺 运动 的 数学 模型 。 访 


模型 没有 咨 轮 ， 因 为 玩具 中 的 齿轮 只 是 为 了 防止 打 
请， 而 在 这 里 不 必 担 心 打 清 。 











图 2-3 ”万 花 尺 数学 模型 


在 图 2-3 中 ，C 是 较 小 的 圆 的 圆心 ，P 是 笔尖 。 
较 大 的 加 半径 为 R， 较 小 的 加 半径 为 r。 半 人 径 之 比 表 
示 如 下 : 


E 
R 


将 线段 PC 与 小 圆 半 径 r 之 比 作为 变量 1 (1 = PC / 
r) ， 它 决定 了 笔尖 离 小 圆 圆心 有 多 远 。 人 然后， 组 
合 这 些 变 量 来 表示 P 的 运动 ， 得 到 如 下 的 参数 方 


ri 
FE: 
; ! x 1—k 
r—R (a — k) cos(8) + 1k cos ( n )) 


; ] 一 天 
gn (a — k)sin(8) + 1k sin ( i 9) ) 














这 些 曲线 称 为 内 旋 轮 线 和 外 旋 轮 线 。 虽 然 方程 可 能 看 起 来 有 点 
De 如 果 你 想 探 索 其 中 的 数学 ， 请 参见 维 
AER. 


图 2-4 展 示 了 如 何 用 这 些 方 程 ， 基 于 参数 的 变 


化 ， 产 生 一 条 曲线 。 通 过 改变 参数 R、r 和 1， 可 以 产 
生变 化 无 穷 的 迷人 曲线 。 


图 2-4 示例 曲线 


将 曲线 绘制 为 一 系列 点 之 间 的 线段 。 如 条 这 些 
氮 足 够 接近 ， 疼 看 起 来 就 像 平滑 的 曲线 。 真 正 玩 过 
万 化 尺 束 知道 ， 这 取决 于 使 用 的 参数 ， 万 论 太 可 能 
需要 许多 转 数 来 完成 。 要 确定 何 时 停止 绘图 ， 就 要 
利用 万 花 尺 的 周期 性 〈 即 万 花 扩 图 案 多 和 久 开始 重 
复 ) ， 研 究 内 外 圆 的 半径 之 比 : 

















R 

分 子 分 母 除 以 它们 的 最 大 公约 数 CGCD) ， 化 
简 访 分数， 分 子 束 告诉 我 们 需要 多 少 圈 才能 完成 曲 
线 。 例 如 ， 在 图 2-4 中 ，(r, R) 的 GCD 是 5。 

下 面 是 该 分 数 化 人 简 后 的 形式 : 

(65/5) _ 13 

这 告诉 我 们 ，13 圈 后 ， 曲 线 将 开始 重复 。44 告 
诉 我 们 小 圆 围绕 其 中 心 旋转 的 圈 数 ， 它 提示 了 曲线 
的 形状 。 在 图 2-4 中 数 一 下 ， 会 看 到 图 形 中 花 办 或 
叶 的 数目 恰好 是 44! 


一 旦 用 简化 形式 表示 了 半径 比 VR， 男 出 螺 线 
的 参数 0 范围 承 是 [0，2rr。 这 告诉 我 们 何 时 停止 给 





制 特 定 的 螺 线 。 不 知道 该 角度 的 结束 范围 ， 融 会 循 
环 不 止 ， 不 必要 地 重复 该 曲线 。 


2.1.2 i5 fa m K 


我 们 可 以 用 Python 的 turtle 模 块 来 创建 图 案 。 这 
是 一 个 简单 的 绘图 程序 ， 模 型 是 一 只 海 包 拖 着 尾巴 
罕 过 沙滩 ， 留 下 图 案 。turtle 模 块 包括 了 一 些 方法 ， 
用 于 设置 笔 (海龟 的 尾巴 ) 的 位 置 和 两 色 ， 以 及 其 
他 有 用 的 绘图 函数 。 如 你 所 见 ， 只 要 少量 绘图 函 
BX, Wa DA Gl) a Ee BAZ o 


例如 ， 这 个 程序 用 turtle 画 圆 。 输 入 以 下 代码 ， 


y— 


保存 为 drawcircle.py， 在 Python 中 运行 它 : 


import math 
€9 import turtle 


# draw the circle using turtle 
def drawCircleTurtle(x, y, r): 
# move to the start of circle 
turtle.up() 
turtle.setpos(x + r, y) 
turtle.down() 


OOOO 


# draw the circle 
for i in range(0, 365, 5): 
a - math.radians(i) 
turtle.setpos(x + r*math.cos(a), y + r*math.sin(a) 


eo9 


Q drawCircleTurtle(100, 100, 50) 
© turtle.mainloop() 





在 @@ 行 ， 从 导入 turtle 模 块 开始 。 接 下 来 ， 定 义 
drawCircleTurtle() 方 法 ， Hire 用 up()。 这 告诉 
Python 提 笔 。 换 句 话 说 ， 让 笔 离开 虚拟 的 纸 ， 这 样 
Bapt tir canis. bs 会 网 之 前 ， 先 定位 海 





在 个 行 ， 将 海龟 的 位 置 设置 为 横 轴 上 的 第 一 个 
点 : (X+r,y)， 其 中 (x，y) 是 该 圆 的 圆心 。 现 在 准备 
Ener. 所 以 在 @ 行 调用 down()。 在 @ 行 ， 利 用 
range(0, 365, 5) 开 始 循环 ， 以 5 为 步 长 递增 变量 1， 从 
0 到 360， 变 量 是 角度 参数 ， 将 传 入 圆 的 参数 方程 ， 
但 首先 在 @ 行 将 它 从 上 度 转 为 弧度 (大 多 数 计算 机 程 
序 的 角度 计算 需要 缴 度 ) 。 


在 @@ 行 ， 利 用 前 面 讨论 过 的 参数 方程 计算 圆 的 
坐标 ， 并 设置 相应 的 海 包 位 置 ， 这 样 就 从 海 包 上 一 
个 位 置 男 线 到 新 计算 的 位 置 〈 从 技术 上 讲 ， 产 生 的 
是 N 边 多 边 形 ， 但 因为 用 了 很 小 的 角度 ，N 将 非 禹 
N, EDU GREAT AD. 

EB, WHldrawCircleTurdeQ2Ki |a], Æ0 

， 调 用 mainloop0， 它 保持 tkinter 窗 口 打开 ， 让 你 
可 以 欣 党 VK N Al (Tkinter 是 Python 上 默认 的 GUI 
库 ) 。 


现在 ， 我 们 准备 好 画 一 些 螺 线 了 ! 

















2.2 ”所 需 模块 


我 们 将 利用 下 面 的 模块 创建 螺 线 : 


。turtle 模 块 用 于 绘图 ; 
。pillow， 这 古 Python 图 像 库 (PIL) 的 一 个 分 
文 ， 用 于 保存 螺 线 图 像 。 
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首先 ， 定 义 类 Sipro， 来 绘制 这 些 曲线 。 我 们 
会 用 这 个 类 一 次 画 一 条 曲线 〈 利 用 draw0 方 法 ) ， 
并 利用 一 个 定时 器 和 update(0) 方 法 ， 产 生 一 组 随机 
螺 线 的 动画 。 为 了 绘制 Spiro 对 象 并 产生 动画 ， 我 们 


将 使 用 SpiroAnimator 类 。 

要 查看 完整 的 项 目 代 码 ， 请 直接 跳 到 2.4 节 。 
2.3.1 ” Spiro 构造 函数 

下 面 是 Spiro 构 造 函 数 : 


# a class that draws a Spirograph 
class Spiro: 
# constructor 
def _ init (self, xc, yc, col, R, r, 1): 


# create the turtle object 
self.t - turtle.Turtle() 

# set the cursor shape 
self.t.shape('turtle') 

# set the step in degrees 
self.step - 5 

# set the drawing complete flag 
self.drawingComplete - False 


oo © © 


# set the parameters 
6 self.setparams(xc, yc, col, R, r, 1) 


# initialize the drawing 
O self.restart() 


在 转行 ，Spiro 构 造 函 数 创 建 一 个 新 的 turtle 对 
BR, MBA FRM A Hills AI. EO, 
将 光标 的 形状 设置 为 海 包 
(FEhttps://docs.python.org/3.3/library/ turtle.html， 
你 可 以 在 turtle 文 档 中 找到 其 他 选项 ) 。 在 全 行 ， 将 
参数 绘图 角度 的 增 量 设置 为 5 度 ， 在 @@ 行 ， 设 置 了 
一 个 标志 ， 将 在 动画 中 使 用 它 ， 它 会 产生 一 组 螺 
线 。 











在 全 和 @ 行 ， 调 用 设置 函数 ， 接 下 来 讨论 该 函 
数 。 


232 ”设置 函数 


现在 让 我 们 看 看 getParams() 方 法 ， 它 帮助 初始 
化 Spiro 对 象 ， 如 下 所 示 : 





# set the parameters 
def setparams(self, xc, yc, col, R, r, 1): 
# the Spirograph parameters 


e self.xc - xc 
self.yc - yc 

eo self.R - int(R) 
self.r - int(r) 
self.l = 1 


self.col = col 


dt 


reduce r/R to its smallest form by dividing with t 
gcdVal - gcd(self.r, self.R) 

self.nRot - self.r//gcdVal 

# get ratio of radii 

self.k - r/float(R) 

# set the color 

self.t.color(*col) 

# store the current angle 


eo 


® self.a = 0 


在 @ 行 ， 保 存 曲 线 中心 的 坐标 。 然 后 在 信行 ， 
将 每 个 圆 的 半径 (RAD) 转换 为 整数 并 保存 这 些 
值 。 在 全 行 ， 用 Python 模块 fractions 内 置 的 gcd() 方 
法 来 计算 半径 的 GCD。 我 们 将 用 这 些 信 息 来 确定 曲 
线 的 周期 性 ， 在 @ 行 将 它 保 存 为 self.nRot。 最 后 ， 
在 人 @ 行 ， 保 存 当 前 的 角度 ， 我 们 将 用 它 来 创建 动 
IH] 。 


2.3.3 ”restart() 方 法 


接 下 来 ，restart() 方 法 重 置 Spiro 对 象 的 绘制 参 
数 ， 让 它 准 备 好 重男 : 





# restart the drawing 
def restart(self): 
# set the flag 


e self.drawingComplete - False 

# show the turtle 
eo self.t.showturtle() 

# go to the first point 
e self.t.up() 
o R, k, 1 = self.R, self.k, self.l 

a = 0.0 
® x = R*((1-k)*math.cos(a) + l*k*math.cos((1- 
k)*a/k)) 

y = R*((1-k)*math.sin(a) - 1*k*math.sin((1- 

k)*a/k)) 
O self.t.setpos(self.xc + x, self.yc + y) 
(7) self.t.down() 





这 里 用 了 布尔 标志 drawingComplete， 来 确定 
绘图 是 否 已 经 完成 ， 在 @ 行 初始 化 该 标志 。 绘 制 多 
个 Spiro 对 象 时 ， 这 个 标记 是 有 用 的 ， 因 为 它 可 以 退 
踩 某 个 特定 的 螺 线 是 否 完成 。 在 仿 行 ， 显 示 海 怨 光 
标 ， 以 防 它 被 隐藏 。 在 全 行 提起 笔 ， 这 样 承 可 以 在 
@@ 行 移动 到 第 一 个 位 置 而 不 画 线 。 在 @@ 行 ， 使 用 了 
一 些 局 部 变量 ， 以 保持 代码 紧凑 。 然 后 ， 在 加 行 ， 
计算 角度 a 设 为 0 时 的 x 和 y 坐 标 ， 以 获得 曲线 的 起 
mo Ba, EOT, Kosh, FARE. 
SetposO 调 用 将 绘制 实际 的 线 。 


2.3.4 ”draw( 方 法 
draw() 方 法 用 连续 的 线段 绘制 该 曲线 。 











# draw the whole thing 
def draw(self): 
# draw the rest of the points 
R, k, 1 = self.R, self.k, self.1 
e for i in range(®, 360*self.nRot + 1, self.step): 
a - math.radians(i) 


(2) x = R*((1-k)*math.cos(a) + l*k*math.cos((1- 
k)*a/k)) 
y = R*((1-k)*math.sin(a) - 1*k*math.sin((1- 
k)*a/k)) 
self.t.setpos(self.xc + x, self.yc + y) 
# drawing is now done so hide the turtle cursor 
e self.t.hideturtle() 
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值 对 应 的 X 和 Y 坐 标 。 在 全 行 ， 隐 藏 光标 ， 因 为 我 们 
己 完 成 绘制 。 


2.3.5 ”创建 动画 


update() 方 法 展示 了 一 段 一 段 绘制 曲线 来 创建 
动画 时 所 使 用 的 绘图 方法 。 





# Update by one step 
def update(self): 
# skip the rest of the steps if done 
e if self.drawingComplete: 
return 
# increment the angle 
eo self.a += self.step 
# draw a step 
R, k, 1 = self.R, self.k, self.1 
# set the angle 
e a = math.radians(self.a) 
x= self.R*((1-k)*math.cos(a) + l*k*math.cos((1- 
k)*a/k)) 
y = self.R*((1-k)*math.sin(a) - l*k*math.sin((1- 
k)*a/k)) 
self.t.setpos(self.xc + x, self.yc + y) 
# if drawing is complete, set the flag 
o if self.a »- 360*self.nRot: 
self.drawingComplete - True 


# drawing is now done so hide the turtle cursor 
self.t.hideturtle() 


在 代行 ，update(0) 方 法 检查 drawingComplete 标 
志 是 否 设 置 。 如 果 没 有 设置 ， 则 继续 执行 代码 其 余 
的 部 分 。 在 @ 行 ，update() 增 加 当前 的 角度 。 从 人 @ 
行 开始 ， 它 计算 当前 角度 对 应 的 (X，Y) MAJ 











将 海 多 移 到 那里 ， 在 这 个 过 程 中 男 出 线段 。 


讨论 万 伦 尺 方程 时 ， 我 提 到 了 曲线 的 周期 性 。 
在 一 定 的 角度 后 ， 万 花 尺 的 网 案 开 始 重 复 。 在 人 @ 
行 ， 检 查 角 上 度 是 否 达 这 条 特定 曲线 计算 的 完整 沁 
围 。 如 果 是 这 样 ， 束 设置 drawingComplete 标 志 ， 
为 绘图 完成 了 了。 最 后 ， 隐 藏 海 怨 光标 ， 你 可 以 看 到 
目 己 美丽 的 创作 。 


2.3.6 ”SpiroAnimator 类 


SpiroAnimator 类 让 我 们 同时 绘制 随机 的 螺 线 。 
该 类 使 用 一 个 计时 右 ， 每 次 绘制 曲线 的 一 段 。 这 种 
技术 定期 更 新 图 像 ， 并 人 多 许 程序 处 理事 件 ， 如 按 
键 、 鼠 标点 击 ， 等 等 。 但 是 ， 这 种 计时 堪 技 术 需 要 
对 绘制 代码 进行 一 些 调整 。 

















4 a class for animating Spirographs 
class SpiroAnimator: 
# constructor 
def _ init (self, N): 
4 set the timer value in milliseconds 


e self.deltaT - 10 
# get the window dimensions 
(2) self.width = turtle.window_width() 


self.height = turtle.window_height() 
# create the Spiro objects 
© self.spiros = [] 
for i in range(N): 
# generate random parameters 


O rparams = self.genRandomParams() 
# Set the Spiro parameters 
® spiro = Spiro(*rparams) 


self.spiros.append(spiro) 
# call timer 


Q turtle.ontimer(self.update, self.deltaT) 
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置 为 10， 这 是 以 量 秒 为 单位 的 时 间 间 隔 ， 将 用 于 定 
时 器 。 在 信行 ， 保 存 海 包 窗 口 的 尺寸 。 然 后 在 合 行 
创建 一 个 空 数 组 ， 其 中 将 填 入 一 些 Spiro 对 象 。 这 些 
封装 的 万 花 尺 绘制 ， 然 后 循环 N 次 (N 传 入 给 构造 
函数 SpiroAnimator〉 ， 在 人 @ 行 创建 一 个 新 的 Spiro 对 
象 ， 并 将 它 添加 到 Spiro 对 象 的 列表 中 。 这 里 的 
rparams 是 一 个 元 组 ， 需 要 传 入 到 Spiro 构 造 函 数 。 
但 是 ， 构 造 函 数 需 要 一 个 参数 列表 ， 上 所 以 用 Python 
的 * 运 算 符 将 元 组 转换 为 参数 列表 。 


最 后 ， 在 @@ 行 ， 设 置 turtle.ontimer(0) 方 法 每 隔 
DeltaT2&f ii] Hjupdate().. 

请 注意 ， 在 人 @ 行 调用 了 一 个 辅助 方法 ， 名 为 
genRandomParams()。 接 下 来 束 看 看 这 个 方法 。 


2.3.7 genRandomParams()7; i7; 
我 们 用 genRandomParams0) 方 法 来 生成 随机 人 参 


数 ， 在 每 个 Spiro 对 象 创 建 时 发 送 给 它 ， 来 生成 各 种 
曲线 。 

















# generate random parameters 
def genRandomParams (self): 
width, height - self.width, self.height 


R - random.randint(50, min(width, height)//2) 
r - random.randint(10, 9*R//10) 
l = random.uniform(0.1, 0.9) 
xc = random.randint(-width//2, width//2) 
yc - random.randint(-height//2, height//2) 
col - (random.random(), 
random.random(), 
random. random) ) 
return (xc, yc, col, R, r, 1) 
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为 了 生成 随机 数 ， 利 用 来 和 目 Python 的 random 模 
块 的 两 个 方法 : randint0)， 它 返回 指定 范围 内 的 随 
机 整数 ， 以 及 uniform0， 它 对 浮 点 数 做 同样 的 事 。 
在 @ 行 ， 将 R 设 置 为 50 至 窗口 短 边 一 半 长 度 的 随机 
整数 ， 在 信行 ， 将 r 设 置 为 R 的 10% 至 90% 之 间 。 


然后 ， 在 信行 ， 将 1 设置 为 0.1 至 0.9 之 间 的 随机 
小 数 。 在 个 和 加 行 ， 在 屏幕 边界 内 随机 选择 x 和 y 坐 
标 ， 选 择 屏 大 上 的 一 个 随机 扣 作 为 螺 线 的 中 心 。 在 
@ 行 随机 设置 为 红 、 绿 和 蓝 颜 色 的 成 分 ， 为 曲线 指 
定 随机 的 颜色 。 最 后 ， 在 @@ 行 ， 所 有 计算 的 参数 作 
为 一 个 元 组 返回 。 


2.3.8 重新 司 动 程序 


我 们 将 用 另 一 个 restart0 方 法 来 重新 启动 程 
序 。 














# restart spiro drawing 
def restart(self): 
for spiro in self.spiros: 
# clear 


spiro.clear() 

# generate random parameters 
rparams = self.genRandomParams( ) 
# set the spiro parameters 
spiro.setparams(*rparams) 

# restart drawing 
spiro.restart() 


CWA BUSpiroXt R, T6 ER EA BU ZZ RU BO T 
条 螺 线 ， 分 配 新 的 螺 线 参数 ， 然 后 重新 司 动 程序 。 


2.3.9 update()7; i7; 

下 面 的 代码 展示 了 SproAnimator 中 的 update0) 方 
法 ， 它 由 定时 占 调 用 ， 以 动画 的 形式 更 新 所 有 的 
Spiro 对 象 : 


def update(self): 
# update all spiros 


e nComplete = 0 
for spiro in self.spiros: 
# update 
(2) spiro.update() 
# count completed spiros 
e if spiro.drawingComplete: 


nComplete += 1 
# restart if all spiros are complete 
o if nComplete -- len(self.spiros): 
self.restart() 
# call the timer 
® turtle.ontimer(self.update, self.deltaT) 


update() 方 法 使 用 一 个 计数 器 nComplete 来 记录 
已 画 的 Spiro 对 象 的 数目 。 在 代行 初始 化 后 ， 它 明 历 


Spiro 对 象 的 列表 ， 在 信行 更 新 它们 ， 如 果 一 个 
Spiro 完 成 ， 就 在 个 行将 计数 器 加 1。 

在 循环 外 的 @ 行 ， 检 查 计数 器 ， 看 看 是 否 所 有 
对 象 都 已 画 完 。 如 果 已 男 完 ， 调 用 restart(0) 方 法 重新 
开始 新 的 螺 线 动画 。 在 人 @ 行 restart() 的 末尾 ， 调 用 计 
时 器 方法 ， 它 在 DeltaT 暑 秒 后 再 次 调用 update()。 


2.3.10 ”显示 或 隐藏 光标 


最 后 ， 使 用 下 面 的 方法 来 打开 或 关闭 海 怨 光 
标 。 这 可 以 让 绘图 更 快 。 











# toggle turtle cursor on and off 
def toggleTurtles(self): 
for spiro in self.spiros: 
if spiro.t.isvisible(): 
spiro.t.hideturtle() 
else: 
spiro.t.showturtle() 


2311 保存 曲线 


使 用 saveDrawing() 方 法 ， 将 绘制 保存 为 PNG 图 
像 文件 。 


# save drawings as PNG files 
def saveDrawing(): 
# hide the turtle cursor 
e turtle.hideturtle() 
# generate unique filenames 
eo dateStr = (datetime.now()).strftime("%d%b%Y - 


%H%M%S " ) 

fileName = 'spiro-' + dateStr 

print('saving drawing to %s.eps/png' % fileName) 
# get the tkinter canvas 

canvas = turtle.getcanvas() 

# save the drawing as a postscipt image 
canvas.postscript(file = fileName + '.eps') 


# use the Pillow module to convert the postscript im 
img = Image.open(fileName + '.eps') 
img.save(fileName + '.png', 'png') 

# show the turtle cursor 
turtle.showturtle() 
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EOI., Vy. RENT STERN 
图 形 中 看 到 它 。 然 后 ， 在 信行 ， 使 用 datetime()， 利 
用 当前 时 则 和 日 期 (以 “日 一 月 一 年 一 时 一 分 一 
秒 ” 的 格式 ) ， 以 生成 图 像 文件 的 唯一 名 称 。 将 这 
个 字符 串 加 在 Spiro- 后 面 ， 生 成 文件 名 。 


turtle 程 序 采 用 tkinter 创 建 的 用 户 界 面 (UI) 窗 
口 ， 在 全 和 人 @ 行 ， 利 用 tkinter 的 canvas 对 象 ， 将 窗 
口 保存 为 散 入 式 PostScript CEPS). 文件 格式 。 由 于 
EPS 是 矢量 格式 ， 你 可 以 用 高 分 辨 率 打 印 它 ， 但 
PNG 用 途 更 广 ， 所 以 在 全 行 用 Pillow 打 开 EPS 文 
件 ， 并 在 @ 行 将 它 保 存 为 PNG 文 件 。 最后， 在 @ 
行 ， 取 消 隐 藏 海 怨 光标 。 


2.3.12 ”解析 命令 行 参数 和 初始 化 


像 第 1 章 中 一 样 ， 在 main() 方 法 中 用 argparse 来 
解析 传 入 程序 的 命令 行 选项 。 

















e parser = argparse.ArgumentParser(description=descStr) 


# add expected arguments 
parser.add argument('-- 
sparams', nargs-3, dest-'sparams', required-False, 


help="The three arguments in sparams 


# parse args 
e args - parser.parse args() 
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行 实际 的 解析 。 


接 下 来 ， 代 人 码 设置 了 一 些 turtle 参 数 。 


# set the width of the drawing window to 80 percent of th 
turtle.setup(width=0.8) 


# set the cursor shape to turtle 
eo turtle.shape('turtle') 


# set the title to Spirographs! 
e turtle.title("Spirographs!") 

# add the key handler to save our drawings 
o turtle.onkey(saveDrawing, "s") 

# start listening 
® turtle.listen() 


# hide the main turtle cursor 
O turtle.hideturtle() 
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参数 ) . EOI, KREME RA, FOr, 
设置 程序 窗口 的 标题 为 Spirographs! , EO9iT, Al 
用 onkey0 和 saveDrawing， 在 按 下 S 时 保存 图 画 。 然 
后 ， 在 全 行 ， 调 用 listen(O) 让 窗口 监听 用 户 事 件 。 最 
后 ， 在 @ 行 ， 隐 藏 海 怨 光 标 。 


命令 行 参数 解析 后 ， 代 码 的 其 余部 分 进行 如 





um 


# check for any arguments sent to 
sparams and draw the Spirograph 
if args.sparams: 
params = [float(x) for x in args.sparams] 
# draw the Spirograph with the given parameters 
col = (0.0, 0.0, 0.0) 


e spiro - Spiro(0, 0, col, *params) 
o spiro.draw() 
else: 
# create the animator object 
® spiroAnim = SpiroAnimator(4) 
# add a key handler to toggle the turtle cursor 
O turtle.onkey(spiroAnim.toggleTurtles, "t") 
# add a key handler to restart the animation 
(7) turtle.onkey(spiroAnim.restart, "space") 
# start the turtle main loop 
e turtle.mainloop() 


在 @ 行 ， 首 先 检查 是 否 有 参数 赋 给 --sparams。 
如 果 有 ， 束 从 字符 串 中 提取 它们 ， 用 “列表 解析 ”将 
它们 转换 成 浮 点 数 人 (列表 解析 是 一 种 Python 结 
构 ， 让 你 以 紧凑 而 强大 的 方式 创建 一 个 列表 ， 例 
如 ，a = [2*x for x in range(1, 5)] 创 建 前 4 个 偶数 的 列 





3€). 


在 信行 ， 利 用 任何 提取 的 参数 来 构造 Spiro 对 
象 《 利 用 Python 的 * 运 算 符 ， 它 将 列表 转换 为 参 
数 ) 。 然 后 ， 在 @ 行 ， 调 用 draw()， 绘 制 螺 线 。 


现在 ， 如 果 命 令 行 上 没有 指定 参数 ， 束 进入 随 
机 模式 。 在 全 行 ， 创 建 一 个 SpiroAnimator 对 象 ， 问 
它 传 入 参数 4， 告 诉 它 创 建 4 幅 图 画 。 在 @@ 行 ， 利 用 
onkey() 来 捕捉 按键 了 ， 这 样 束 可 以 用 它 来 切换 海 包 
光标 (toggleTurtles 〉， 在 人 @ 行 ， 处 理 空格 刍 
(space) ， 这 样 束 可 以 用 它 在 任何 时 候 重 新 启动 动 
画 。 最 后 ， 在 候 行 ， 调 用 mainloopO 告 诉 tkinter 窗 口 
保持 打开 ， 监 听 事 件 。 











2.4 


完整 代位 





下 面 是 完整 的 万 花 尺 程序 。 也 可 以 从 
https://github.com/electronut/pp/blob/master/ 
spirograph/spiro.py 下 载 该 项 目的 代码 。 


import 
import 
import 
import 
import 


sys, random, argparse 
numpy as np 

math 

turtle 

random 


from PIL import Image 
from datetime import datetime 
from fractions import gcd 


# a class that draws a Spirograph 
class Spiro: 
# constructor 
def _ init (self, xc, yc, col, R, r, 1): 


# create the turtle object 
self.t = turtle.Turtle() 

# set the cursor shape 
self.t.shape('turtle') 


# set the step in degrees 
self.step = 5 

# set the drawing complete flag 
self.drawingComplete - False 


4 set the parameters 
self.setparams(xc, yc, col, R, r, 1) 


# initialize the drawing 
self.restart() 


# set the parameters 
def setparams(self, xc, yc, col, R, r, 1): 


# the Spirograph parameters 
self.xc = xc 
self.yc - yc 


self.R - int(R) 
self.r - int(r) 
self.l = 1 


self.col = col 

# reduce r/R to its smallest form by dividing with th 
gcdVal = gcd(self.r, self.R) 

self.nRot = self.r//gcdVal 

# get ratio of radii 

self.k = r/float(R) 

# set the color 

self.t.color(*col) 

# store the current angle 

self.a= 0 


# restart the drawing 


def 


restart(self): 

# set the flag 
self.drawingComplete = False 
# show the turtle 
self.t.showturtle() 

# go to the first point 


self.t.up() 

R, k, 1 = self.R, self.k, self.l 

a= 0.0 

x = R*((1-k)*math.cos(a) + 1*k*math.cos((1-k)*a/k)) 


y R*((1-k)*math.sin(a) - l*k*math.sin((1-k)*a/k)) 
self.t.setpos(self.xc + x, self.yc + y) 
self.t.down() 


# draw the whole thing 


def 


k)*a/k)) 


k)*a/k)) 


draw(self): 
# draw the rest of the points 
R, k, 1 = self.R, self.k, self.l 
for i in range(0, 360*self.nRot + 1, self.step): 
a - math.radians(i) 
x = R*((1-k)*math.cos(a) + l*k*math.cos((1- 


y = R*((1-k)*math.sin(a) - 1*k*math.sin((1- 
self.t.setpos(self.xc + x, self.yc + y) 
# drawing is now done so hide the turtle cursor 


self.t.hideturtle() 


# update by one step 
def update(self): 


# skip the rest of the steps if done 
if self.drawingComplete: 
return 
# increment the angle 
self.a += self.step 
# draw a step 
R, k, 1 = self.R, self.k, self.l 
# set the angle 
a - math.radians(self.a) 
X = self.R*((1-k)*math.cos(a) + l*k*math.cos((1- 
k)*a/k)) 
y = self.R*((1-k)*math.sin(a) - 1*k*math.sin((1- 
k)*a/k)) 
self.t.setpos(self.xc + x, self.yc + y) 
# if drawing is complete, set the flag 
if self.a »- 360*self.nRot: 
self.drawingComplete - True 
# drawing is now done so hide the turtle cursor 
self.t.hideturtle() 


# clear everything 
def clear(self): 
self.t.clear() 


# a class for animating Spirographs 
class SpiroAnimator: 
# constructor 
def _ init (self, N): 
# set the timer value in milliseconds 
self.deltaT - 10 
# get the window dimensions 
self.width - turtle.window width() 
self.height - turtle.window height() 
# create the Spiro objects 
self.spiros - [] 
for i in range(N): 
# generate random parameters 
rparams = self.genRandomParams( ) 
# set the spiro parameters 
spiro - Spiro(*rparams) 
self.spiros.append(spiro) 
# call timer 
turtle.ontimer(self.update, self.deltaT) 


# restart spiro drawing 
def restart(self): 
for spiro in self.spiros: 
# clear 


spiro.clear() 

# generate random parameters 
rparams = self.genRandomParams( ) 
# set the spiro parameters 
spiro.setparams(*rparams) 

# restart drawing 
spiro.restart() 


# generate random parameters 
def genRandomParams (self): 
width, height - self.width, self.height 


R - random.randint(50, min(width, height)//2) 
r - random.randint(10, 9*R//10) 

l - random.uniform(0.1, 0.9) 

xc = random.randint(-width//2, width//2) 

yc - random.randint(-height//2, height//2) 


col - (random.random(), 
random.random(), 
random. random() ) 

return (xc, yc, col, R, r, 1) 


def update(self): 
# update all spiros 
nComplete = 0 
for spiro in self.spiros: 
# update 
spiro.update() 
# count completed spiros 
if spiro.drawingComplete: 
nComplete += 1 
# restart if all spiros are complete 
if nComplete == len(self.spiros): 
self.restart() 
# call the timer 
turtle.ontimer(self.update, self.deltaT) 


# toggle turtle cursor on and off 
def toggleTurtles(self): 
for spiro in self.spiros: 
if spiro.t.isvisible(): 
spiro.t.hideturtle() 
else: 
spiro.t.showturtle() 


# save drawings as PNG files 
def saveDrawing(): 
# hide the turtle cursor 
turtle.hideturtle() 


# generate unique filenames 

dateStr = (datetime.now()).strftime("%d%b%Y -96H96M96S "" ) 
fileName = 'spiro-' + dateStr 

print('saving drawing to %s.eps/png' % fileName) 

# get the tkinter canvas 

canvas - turtle.getcanvas() 

# save the drawing as a postscipt image 
canvas.postscript(file = fileName + '.eps') 

# use the Pillow module to convert the poscript image fil 
img = Image.open(fileName + '.eps') 
img.save(fileName + '.png', 'png') 

# show the turtle cursor 

turtle.showturtle() 


# main() function 
def main(): 
# use sys.argv if needed 


print('generating spirograph...') 
# create parser 
descStr = """This program draws Spirographs using the Tur 


When run with no arguments, this program draws random Spi 
Terminology: 


R: radius of outer circle 
r: radius of inner circle 
l: ratio of hole distance to r 


parser = argparse.ArgumentParser(description=descStr) 


# add expected arguments 
parser.add argument('-- 
sparams', nargs-3, dest-'sparams', required-False, 
help="The three arguments in sparams: 


# parse args 
args - parser.parse args() 


# set the width of the drawing window to 80 percent of th 
turtle.setup(width=0.8) 


# set the cursor shape to turtle 
turtle.shape( 'turtle') 


# set the title to Spirographs! 
turtle.title("Spirographs!") 
# add the key handler to save our drawings 


turtle.onkey(saveDrawing, "s") 
# start listening 
turtle.listen() 


# hide the main turtle cursor 
turtle.hideturtle() 


# | check for any arguments sent to 
sparams and draw the Spirograph 
if args.sparams: 
params - [float(x) for x in args.sparams] 
draw the Spirograph with the given parameters 
col - (0.0, 0.0, 0.0) 
spiro - Spiro(0, 0, col, *params) 
spiro.draw() 
else: 
# create the animator object 
spiroAnim - SpiroAnimator(4) 
# add a key handler to toggle the turtle cursor 
turtle.onkey(spiroAnim.toggleTurtles, "t") 
# add a key handler to restart the animation 
turtle.onkey(spiroAnim.restart, "space") 


# start the turtle main loop 
turtle.mainloop() 


# call main 
if _name__ == ' main ': 
main() 


2.5 ZITIERTE 





现在 该 运行 程序 了 。 


$ python spiro.py 


默认 情况 下 ，spiro.py 程 序 绘制 随机 螺 线 ， 如 
图 2-5 所 示 。 按 S 键 保存 绘制 。 


FS 
Y A 
| NM 
NY 
N 
N 





图 2-5 spiro.py 的 运行 示例 


现在 ， 再 次 运行 程序 ， 这 次 在 命令 行 传 入 参 
数 ， 画 出 特定 的 螺 线 。 


$ python spiro.py --sparams 300 100 0.9 


图 2-6 展 示 了 输出 结果 。 如 你 所 见 ， 这 段 代 码 
根据 用 户 指 定 的 参数 绘制 了 一 条 螺 线 ， 图 2-5 和 人 它 
不 同 ， 展 示 了 几 个 随机 螺 线 的 动画 。 








图 2-6 ”用 具体 参数 运行 spiro.py 的 示例 


2 0 车 


在 这 个 项 目 中 ， 我 们 学 习 了 如 何 创 建 万 花 尺 那 
样 的 曲线 。 我 们 还 和 学习 了 如 何 调整 输入 参数 ， 来 生 
成 各 种 不 同 的 曲线 ， 并 在 屏幕 上 产生 动画 。 我 希望 
你 喜欢 创造 这 些 螺 线 〈 在 第 13 章 你 会 惊喜 地 发 现 ， 
可 以 学 到 如 何 将 螺 线 投影 到 墙 上 ) 。 
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下 面 有 一 些 方法 可 以 进一步 符 试 螺 线 。 


1. 现在 你 已 知道 如 何 画 圆 ， 请 写 一 个 程序 来 
绘制 随机 的 对 数 螺 线 。 找 到 参数 形式 的 对 数 螺 线 方 
程 ， 然 后 用 它 来 绘制 螺 线 。 


2. 你 可 能 已 经 注意 到 ， 画 曲线 时 ， 海 怨 光 标 
总 是 因 右 ， 但 这 不 是 海 怨 移动 的 方式 ! 请 调整 海 包 
的 方 同 ， 在 绘制 曲线 时 ， 让 和 它 绷 同 绘制 的 方 同 〈 提 
AN: 每 步 计算 连续 点 之 间 的 方向 矢量 ， 用 
turtle.setheading(0) 方 法 来 调整 海龟 的 方 同 ) 。 

3. 尝试 用 海 包 绘制 Koch snowflake CREER 


4E) ， 它 是 利用 递归 〈 即 调用 自身 的 函数 ) 的 分 形 
曲线 。 可 以 像 这 样 组 织 递 归 函 数 调用 : 











# recursive Koch snowflake 
def kochSF(x1, y1, x2, y2, t): 
# compute intermediate points p2, p3 
if segment length » 10: 
# recursively generate child segments 
# flake #1 


kochSF(x1, y1, p1[0], pi[1], t) 

# flake #2 

kochSF(p1[0], p1[1], p2[0], p2[1], t) 
# flake #3 


kochSF(p2[0], p2[1], p3[0], p3[1], t) 
# flake #4 


kochSF(p3[0], p3[1], x2, y2, t) 
else: 

# draw 

Ho... 


如 果 你 确实 过 到 困难 ， 可 以 
在 http ://electronut.in/koch-snowflake-and-the-thue- 
morse-sequence/ 找 到 我 的 解决 方案 。 


[1] http://en.wikipedia.org/wiki/Spirograph/" - 
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第 二 部 分 “模拟 生命 


“首先 ， 我 们 假设 奶牛 是 一 个 球体 。” 


一 一 佚名 物理 学 笑话 





第 3 草 Conway fi iit xX 








你 可 以 用 计算 机 来 研究 一 个 系统 ， 方 法 是 建立 
该 系统 的 数学 模型 ， 编 程 表 示 访 模型 ， 然 后 让 该 模 
型 随 着 时 间 的 推移 而 演进 。 有 很 多 种 计算 机 模拟 ， 
但 我 会 专注 于 一 个 著名 的 模拟 ， 即 Conway 和 生命 游 
戏 ， 它 是 英国 数学 家 John ” Conway 的 成 果 。 和 生命 游 
戏 是 细胞 上 自动 机 ， 即 网 格 上 的 一 组 彩色 细胞 ， 根 据 
定义 相 邻 细胞 状态 的 一 组 规则 ， 经 过 一 些 时 间 逐 步 
演进 。 

这 个 项 目 将 创建 一 个 NxN 的 细胞 网 格 ， 通 过 应 
用 Conway 生 命 游 戏 的 规则 ， 模 拟 系统 随时 间 的 演 
进 。 你 将 显示 每 个 时 间 段 的 游戏 状态 ， 并 提供 一 些 





方式 将 输出 保存 到 文件 。 你 会 设置 系统 的 初始 状 


态 ， 要 么 是 随机 分 布 ， 要 么 是 预先 设计 的 图 案 。 


该 模拟 由 以 下 几 部 分 组 成 : 


。 在 一 维 或 两 维 空 间 中 定义 的 属性 ; 

。 Dem 改变 这 种 属性 的 数学 规 
N; 

. 随 着 系统 的 演进 ， 显 示 或 记录 系统 状态 的 广 


式 。 


在 Conway 生 命 游 戏 中 的 细胞 可 以 处 于 ON 或 
OFF 状 态 。 游 戏 从 一 个 初始 状态 开始 ， 其 中 每 个 细 
胞 分 配 一 个 状态 ， 数 学 规则 决定 其 状态 如 何 随时 间 
而 改变 。Conway 生 命 游 戏 中 令 人 惊奇 的 是 ， 只 有 4 
个 简单 的 规则 ， 系 统 演 进 会 产生 行为 极其 复杂 的 图 
R, DRENERE. KREEM”, BEN 
LIS), “HIZIR”, BUDJHEONAIOFF, EG 
DISES 

当然 ， 这 个 游戏 的 哲学 音义 也 很 重要 ， 因 为 它 
们 表明 ， 复 杂 的 结构 可 以 根据 简单 的 规则 演进 ， 不 
必 遵 循 任何 一 种 预 设 的 模式 。 

下 面 是 该 项 目 包含 的 一 些 主要 概念 : 

















。 利 用 matplotlib imshow 来 展示 数据 的 二 维 网 格 ; 


。 利 用 matplotlib 生 成 动画 ; 

。 使 用 numpy 数 组 ，; 

。 将 % 运 算 符 用 于 边界 条 件 ; 
。 设 置 值 的 随机 分 布 。 





3.1 工作 原理 


因为 生命 游戏 建立 在 9 个 方 格 的 网 格 中 ， 每 个 
细胞 有 8 个 相 令 细胞， 如 图 3-1 所 示 。 模 拟 中 的 给 定 
细胞 Gi, j) 用 二 维 数组 [i][j] 来 存 取 ， 其 中 i 和 j 分 别 是 行 
和 列 的 下 标 。 在 给 定时 间 段 ， 给 定 细 胞 的 值 取决 于 
前 一 时 间 段 它 的 邻居 的 状态 。Conway 生 命 游 戏 有 4 
个 规则 。 


1. 如 果 一 个 细胞 为 ON， 令 居中 少 于 两 个 为 
ON， 它 变 为 OFF。 

2. 如 果 一 个 细胞 为 ON， 邻 居中 有 两 个 或 3 个 
为 ON， 它 保持 为 ON。 

3， 如 果 一 个 细胞 为 ON， 邻 居中 超过 3 个 为 
ON， 它 变 为 OFF。 


4. 如 果 一 个 细胞 为 OFF， 领 居中 恰好 有 3 个 为 
ON， 它 变 为 ON。 











图 3-1 8 个 相 邻 细胞 





这 些 规则 是 为 了 反映 一 些 基本 方式 ， 即 一 群生 
物体 随时 间 推 移 的 遭遇 :， 如 果 细 胞 邻居 少 于 2 或 多 
于 3， 种 群 太 少 或 种 群 太 多 都 会 杀 死 细胞 ， 将 细胞 
变 为 OFF;， 如 果 种 群 平衡 ， 细 胞 保持 为 ON 并 繁殖 ， 
将 另 一 个 细胞 从 OFF 变 为 ON。 但 是 ， 在 网 格 边 缘 的 
细胞 呢 ? 哪些 细胞 是 自己 的 邻居 ? 要 回答 这 个 问 
题 ， 就 要 考虑 边界 条 件 ， 决 定 细胞 在 网 格 边 缘 或 边 
界 时 的 规则 。 我 将 采用 环形 边界 条 件 ， 这 意味 着 正 





方形 网 格 郑 起 来 ， 构 成 一 个 环 面 ， 从 而 解决 这 个 问 
题 。 如 图 3-2 所 示 ， 网 格 爷 郑 起 来 ， 使 它 的 水 平 这 
x (AMIB) 相连 ， 形 成 一 个 圆柱 体 ， 然 后 圆柱 体 
的 垂直 边缘 (CHD) 相连 ， 以 形成 一 个 坏 面 。 形 
a P8 A HAs Fe» TAA ES LIRE SC 
边缘 。 





图 3-2” 环 型 边界 条 件 的 概念 视图 





这 类 似 于 Pac-Man 〈 吃 豆子 ) 在 边界 的 工作 方式 。 如 果 超 出 了 
屏幕 的 项 部， 就 会 重新 在 底部 出 现 。 如 果 超 出 了 屏幕 的 左 侧 ， 就 会 
重新 在 右 侧 出 现 。 这 种 边界 条 件 在 二 维 模 拟 中 很 常见 。 

以 下 是 算法 描述 ， 我 们 用 它 来 应 用 这 4 个 规 
则 ， 并 运行 模拟 。 

1. 初始 化 网 格 中 的 细胞 。 

2. 在 模拟 的 每 个 时 间 段 ， 对 于 网 格 中 每 个 细 
胞 (i, j)， 做 下 面 的 事 : 

a. 根据 它 的 邻居 更 新 细胞 (i， j 的 值 ， 同 时 考 
虑 到 边界 条 件 ; 


b. 更 新 网 格 值 的 显示 。 











3.0 ”所 需 模块 


用 numpy 数 组 和 matplotlib 库 来 显示 模拟 的 输 
出 ， 用 nn animation 模 块 更 新 模拟 〈 对 于 
matplotlib 的 综述 见 第 1 章 〉。 


3.3 NH 


我 们 将 在 Python 解 释 右 中 一 点 一 点 地 为 模拟 编 
BMS, SSAA ATS AR. BAAS 
整 的 项 目 代 码 ， 请 直接 跳 到 3.4 节 。 


首先 ， 寻 入 该 项 目 使 用 的 模块 : 


>>> import numpy as np 
>>> import matplotlib.pyplot as plt 
>>> import matplotlib.animation as animation 


现在 让 我 们 创建 网 格 。 
3.3.1 表示 网 格 


为 了 在 网 格 上 表示 细胞 的 活 CONO 或 死 
(OFF) ， 分 别 用 255 和 0 作为 ON 和 OFE 的 值 。 我 们 
将 采用 matplotlib 的 imshow0 方 法 ， 来 显示 网 格 当前 
的 状态 ， 将 一 个 数字 矩阵 表示 为 一 张 图 像 。 请 输入 
以 下 内 容 : 
@ >>> x = np.array([[0, 0, 255], [255, 255, 0], [0, 255, 0]] 


© >>> plt.imshow(x, interpolation-'nearest') 
plt.show() 


在 @ 行 ， 定义 了 3x3 的 二 维 numpy 数 组 ， 数 组 
中 的 每 个 元 素 是 一 个 整数 值 。 然 后 ， 在 信行 ， 用 
plt.show(0) 方 法 将 这 个 矩阵 的 值 显 示 为 网 像 ， "i 
interpolation 选 项 传 入 "mearest' 值 ， 以 得 到 尖锐 的 边 
缘 《〈 人 否则 是 模糊 的 ) 。 


图 3-3 展 示 了 这 段 代码 的 输出 。 





图 3-3 ”显示 网 格 的 值 


注意 ，0 (OFF) 显示 为 暗 灰 色 ，255 COND 
显示 为 浅 灰 色 ， 这 是 imshowO 使 用 的 默认 凑 色 。 


3.3.2 ”初始 条 件 


要 开始 模拟 ， 先 为 二 维 网 格 中 的 每 个 细胞 设置 
一 个 初始 状态 。 可 以 使 用 ON 和 OFF 细 胞 的 随机 分 
布 ， 看 看 会 出 现 怎样 的 图 案 ， 或 者 添加 一 些 特定 的 
E" ， 看 看 它们 如 何 发 展 。 我 们 将 探讨 这 两 种 方 
1 





BRKAIN, SL HinumpyH? 
random 模 拟 的 choice(0) 方 法 。 输 入 以 下 内 容 : 


np.random.choice([0, 255], 4*4, p=[0.1, 0.9]).reshape(4, 4) 


array([[255, 255, 255, 255], 
[255, 255, 255, 255], 
[255, 255, 255, 255], 
[255, 255, 255, 0]]) 


np.random.choice 从 给 定 的 列表 [0,255] 中 选择 一 
= 每 个 值 出 现 的 概率 由 参数 p=[0.1，0.9] 指 定 。 
， 你 要 求 0 出 现 的 概率 是 0.1 (或 10%) ，255 出 
i BER E909 (Cp 中 两 个 值 相 加 必须 等 于 1) 。 
为 这 个 choice0) 方 法 创建 了 16 个 值 的 一 维 数组 ， 所 以 
用 .reshape 使 它 成 为 一 个 二 维 数组 。 


要 建立 初始 条 件 来 匹配 特定 图 采 ， 而 不 是 只 十 
一 组 随机 值 ， 就 将 二 维 网 格 初始 化 为 零 ， 然后 用 


一 个 方法 在 网 格 的 特定 行 和 列 增加 一 个 图 案 ， 如 下 
Bran: 


def addGlider(i, j, grid): 
"""adds a glider with top left cell at (i, j)""" 
@ glider = np.array([[0, ©, 255], 
[255, 0, 255], 
[0, 255, 255]]) 
(2) grid[i:i+3, j:j+3] = glider 
6 grid = np. zeros(N* We reshape(N, N) 
@ S de 1, grid) 


在 @ 行 ， 用 3x3 的 numpy 数 组 定义 了 滑翔 机 图 

案 (看 上 去 是 一 种 在 网 格 中 平稳 穿越 的 图 案 ) . 在 
OG, n 可 以 看 到 如 何 用 numpy 的 切片 操作 ， 将 这 种 
图 案 数组 复制 到 模拟 的 二 维 网 格 中 ， 它 的 左上 角 放 
在 i 和 j 指 定 的 坐标 。 在 信行 ， 创 建 NxN 的 零 值 数 
组 ， 在 @ 行 ， 调 用 addGlider0) 方 法 ， 初 始 化 带 有 背 
翔 机 图 案 的 网 格 。 


333 ”边界 条 件 


现在 ， 我 们 可 以 想 一 下 如 何 实现 环形 边界 条 
件 。 首 先 ， 让 我 们 看 看 在 NxN 网 格 的 右边 缘 会 发 生 
什么 情况 。i 行 最 后 一 个 细胞 用 grid[i][N-1] 来 访问 。 
它 右 侧 的 邻居 是 grid[i][N]， 但 根据 环形 边界 条 件 ， 
grid[i][N] 访 问 的 值 应 该 由 grid[i][0] 人 代替。 下 面 是 一 
种 实现 方法 : 








if j == N-1: 

right = grid[i][9] 
else: 

right = grid[i][j+1] 


当然 ， 需 要 在 网 格 的 左 侧 ， 顶 部 和 底部 应 用 类 
似 的 边界 条 件 ， 但 这 样 做 要 加 入 许多 代码 ， 因 为 需 
要 检测 网 格 的 4 个 边缘 。 更 简洁 的 方式 是 用 Python 
的 取 模 CH) HF, Ul b Br: 





>>> N = 16 

>>> 11 = 14 
>>> 12 = 15 
>>> (i1+1)%N 


>>> (12+1)%N 
0 


如 你 所 见 ，% 运 算 和 从 给 出 整数 除 以 N 的 余数 。 
可 以 用 这 个 运算 符 让 值 在 边缘 折返， 像 这样 重 写 网 
格 访问 代码 : 


right = grid[i][(j+1)%N] 


现在 ， 如 果 一 个 细胞 在 网 格 边缘 〈 换 言 之 ， 如 
果 j= N-1) ， 用 这 种 方法 请 求 右边 的 细胞 就 会 得 到 (j 
+1) %N， 这 将 j 设 回 0， 让 网 格 右 侧 卷曲 到 左 侧 。 如 
果 在 网 格 故 部 做 同样 的 事 ， 它 就 折返 到 顶部 。 





334 ”实现 规则 


生命 游戏 的 规则 基于 相 邻 细胞 的 ON 或 OFF 数 
目 。 为 了 简化 这 些 规则 的 应 用 ， 可 以 计算 出 处 于 
ON 状态 的 相 邻 细胞 总 数 。 因 为 ON 状态 的 值 为 
255， 上 所 以 可 以 对 所 有 相 邻 细胞 的 值 求 和 ， 再 除 以 
255， 来 获得 ON 细胞 的 数量 。 下 面 是 相关 的 代码 : 





# apply Conway's rules 
if grid[i, j] == ON: 
e if (total « 2) or (total » 3): 
newGrid[i, j] - OFF 
else: 
if total -- 3: 
(2) newGrid[i, j] = ON 


EO, MRD F2T HASAN Hd AONE S T3 
个 相 邻 细胞 为 ON， 该 细胞 束 由 ON 变 成 OFF。 奥 行 
代码 仅 适 用 于 OFF 细 胞 : 如 果 恰 好 有 3 个 相 邻 细胞 
为 ON， 该 细胞 束 变 成 ON。 

现在 该 编写 模拟 的 完整 代码 了 。 

3.3.5 ”回程 序 发 送 命 令 行 参 数 

下 面 的 代码 向 程序 发 送 命令 行 参数 : 


# main() function 
def main(): 


# command line argumentss are in sys.argv[1], sys.argv[2], .. 


# sys.argv[0] is the script name and can be ignored 
@ # parse arguments 


parser = argparse.ArgumentParser(description="Runs Conway's G 
simulation.") 

# add arguments 

@ parser.add_argument('--grid- 

size', dest='N', required=False) 

® parser.add_argument('--mov- 

file', dest='movfile', required=False) 

© parser.add_argument('-- 

interval', dest-'interval', required-False) 

® parser.add_argument('-- 

glider', action-'store true', required-False) 
args - parser.parse args() 


main() 函 数 首 先 定义 了 程序 的 命令 行 参数 。 在 
OO 行 ， 用 argparse 类 为 代码 添加 命令 行 选项 ， 然 后 
€ 在 信行 ， 指 定 模拟 
网 格 的 大 小 N。 在 全 行 ， 指 定 保存 .mov 文 件 的 名 
称 。 在 @@ 行 ， 设 置 动画 更 新 间隔 的 毫 种 数 。 在 @@ 
行 ， 用 清 翔 机 图 和 案 开 始 模拟 。 


3.3.6 ”初始 化 模拟 
继续 看 代码 ， 接 下 来 一 段 ， 对 模拟 初始 化 : 





# set grid size 

N - 100 

if args.N and int(args.N) » 8: 
N - int(args.N) 


# set animation update interval 
updatelnterval - 50 
if args.interval: 

updateInterval - int(args.interval) 


# declare grid 
@ grid = np.array([]) 

# check if "glider" demo flag is specified 

if args.glider: 
grid - np.zeros(N*N).reshape(N, N) 
addGlider(1, 1, grid) 

else: 
# populate grid with random on/off - more off than on 
grid - randomGrid(N) 


仍 在 main0 函 数 内 ， 命 令 行 选 项 解析 后 ， 这 部 
分 代码 应 用 命令 行 传 入 的 所 有 参数 。 例 如 ，@ 行 后 
的 几 行 设置 初始 条 件 ， 要 么 是 默认 的 随机 图 案 ， 要 
么 是 滑翔 机 图 案 。 最 后 ， 设 置 动画 。 


# set up the animation 
@ fig, ax = plt.subplots() 
img - ax.imshow(grid, interpolation-'nearest') 
ani - animation.FuncAnimation(fig, update, fargs- 
(img, grid, N, ), 
frames-10, 
interval-updateInterval, 
save count-50) 
# number of frames? 
# set the output file 
if args.movfile: 
ani.save(args.movfile, fps-30, extra args-['- 
vcodec', 'libx264']) 


plt.show() 


在 代行 ， 配 置 matplotlib 的 绘图 和 动画 参数 。 在 
急行 ，animation.FuncAnimation0 调 用 函数 
update0， 该 函数 在 前 面 的 程序 中 定义 ， 根 据 





Conway 生 命 游 戏 的 规则 ， 采 用 环形 边界 条 件 来 更 
新 网 格 。 
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下 面 是 生命 模拟 游戏 的 完整 程序 。 也 可 以 从 


https://github.com/electronut/pp/blob/ 
masterconway/conway.py 下 载 该 项 目的 代码 。 


import sys, argparse 

import numpy as np 

import matplotlib.pyplot as plt 

import matplotlib.animation as animation 


ON - 255 
OFF - 0 
vals - [ON, OFF] 


def randomGrid(N): 

"""returns a grid of NxN random values""" 

return np.random.choice(vals, N*N, p- 
[0.2, 0.8]).reshape(N, N) 


def addGlider(i, j, grid): 
"""adds a glider with top-left cell at (i, j)""" 
glider = np.array([[0, 0, 255], 
[255, 0, 255], 
[0, 255, 255]]) 
grid[i:i+3, j:j+3] = glider 


def update(frameNum, img, grid, N): 
# copy grid since we require 8 neighbors for calculation 
# and we go line by line 
newGrid = grid.copy() 
for i in range(N): 
for j in range(N): 
# compute 8- 
neghbor sum using toroidal boundary conditions 
# x and y wrap around so that the simulation 
# takes place on a toroidal surface 
total = int((grid[i, (j-1)%N] + grid[i, (j+1)%N] + 


grid[(i-1)%N, j] + grid[(i+1)%N, j] + 
grid[(i-1)%N, (j-1)*N] + grid[(i- 
1)%N, (j+1)%N] + 
grid[(i-1)9N, (j- 
1)%N] + grid[(i+1)%N, (j+1)%N])/255) 
# apply Conway's rules 
if grid[i, j] == ON: 
if (total < 2) or (total > 3): 
newGrid[i, j] = OFF 
else: 
if total == 
newGrid[i, j] = ON 


# update data 
img.set_data(newGrid) 
grid[:] = newGrid[:] 
return img, 


# main() function 
def main(): 


# command line arguments are in sys.argv[1], sys.argv[2], 
# sys.argv[0] is the script name and can be ignored 
# parse arguments 


parser = argparse.ArgumentParser(description="Runs Conway's G 
simulation.") 
# add arguments 

parser.add argument('--grid- 

size', dest='N', required-False) 
parser.add argument( '--mov- 

file', dest-'movfile', required-False) 
parser.add argument('-- 

interval', dest-'interval', required-False) 
parser.add argument('-- 

glider', action-'store true', required-False) 
parser.add argument('-- 

gosper', action-'store true', required-False) 
args - parser.parse args() 


# set grid size 

N = 100 

if args.N and int(args.N) » 8: 
N - int(args.N) 


# set animation update interval 
updatelnterval - 50 
if args.interval: 


updateInterval = int(args.interval) 


# declare grid 
grid - np.array([]) 
# check if "glider" demo flag is specified 
if args.glider: 
grid - np.zeros(N*N).reshape(N, N) 
addGlider(1, 1, grid) 
else: 
# populate grid with random on/off - more off than on 
grid - randomGrid(N) 


# set up the animation 
fig, ax - plt.subplots() 
img - ax.imshow(grid, interpolation-'nearest') 
ani - animation.FuncAnimation(fig, update, fargs- 
(img, grid, N, ), 
frames-10, 
interval-updateInterval, 
save count-50) 
# number of frames? 
# set the output file 
if args.movfile: 
ani.save(args.movfile, fps-30, extra args-['- 
vcodec', 'libx264']) 


plt.show() 
# call main 
if name == ' main ': 


main() 


3.5 ”运行 模拟 人 生 的 游戏 


现在 运行 代码 : 


$ python3 conway .py 


这 里 采用 模拟 的 默认 参数 : 100x100 个 细胞 的 
网 格 ，50 毫 秒 的 更 新 间隔 。 观 看 模拟 时 ， 你 会 看 到 
它 如 何 进行 ， 随 着 时 间 的 推移 创建 并 保持 各 种 图 
案 ， 如 图 3-4 所 示 。 





lol b) 
图 3-4 ”进行 中 的 生命 游戏 
图 3-5 展 示 了 模拟 中 可 以 寻找 的 一 些 图 案 。 除 
了 滑翔 机 ， 请 寻找 3 细胞 的 内 区 灯 ， 以 方 英 或 面包 
HITZ ARS HAS IE 


现在 ， 改 变 一 下 ， 用 这 些 参 数 来 运行 模拟 : 





$ python conway .py --grid-size 32 --interval 500 --glider 


这 创建 了 32x32 的 模拟 网 格 ， 每 500 宣 秒 更 新 动 
画 ， 并 采用 初始 的 滑翔 机 图 案 ， 如 图 3-5 的 右 下 图 
所 示 。 








方块 面包 





闪光 灯 《第 2 阶段 ) 滑翔 机 
图 3-5 ”生命 游戏 中 的 图 采 


3.6 小结 





这 个 项 目 探讨 了 Conway 生 命 游戏 。 我 们 学 习 
了 如 何 基 于 某 些 规则 ， 来 建立 基本 的 计算 机 模拟 ， 
以 及 如 何 用 matplotlib， 随 着 系统 的 演进 ， 让 系统 的 
状态 可 视 化 。 

我 们 的 Conway 和 生命 游 戏 实 现 更 强调 简单 ， 而 
不 是 性 能 。 有 许多 不 同 的 方式 可 以 加 快 生命 游 戏 的 
计算 ， 关 于 如 何 做 到 这 一 点 ， 有 大 量 的 研究 。 快 速 
在 互联 网 搜索 一 下 ， 会 发 现 很 多 这 样 的 研究 。 











3.7 实验 


下 面 有 一 些 方法 ， 可 以 进一步 试验 Conway 生 

1. 编写 addGosperGun() 方 法 ， 在 网 格 中 添加 
如 图 3-6 所 示 的 图 宁 。 这 种 图 肥 被 称 为 “局 斯 由 滑翔 
机 枪 CGosper Glider Gun) ”。 运 行 模拟 并 观察 枪 的 
行为 。 

2. 编写 readPattern() 方 法 ， 从 文本 文件 读 取 初 
TA, FAC REBUN RAR. PREY 
文件 的 建议 格式 : 


8 
000255 ... 
E 
H NH 
EH EN il uil 
u u EN ED 
L|] a u EN 
lii a H HH H H 
ili E 
i il 
we 


图 3-6 ”高 斯 则 滑翔 机 枪 


该 文件 的 第 一 行 定义 了 N， 其 余部 分 是 NxN 个 
整数 《0 或 255) ， 由 空格 阳 开 。 你 可 以 用 Python 的 
方法 ， 如 open 和 file.read 来 实现 。 这 种 探索 有 助 于 研 
完 任 何 给 定 的 图 条 在 生命 游戏 规则 下 是 如 何 汗 变 
有 的。 添加 命令 行 选项 --pattern-file， 在 运行 程序 时 使 
用 此 文件 。 





第 4 章 ， 用 Karplus-Strong 算 法 产生 
RA 








任何 乐音 的 主要 特点 是 它 的 音调 ， 即 频率 。 这 
是 每 秒 的 振动 数 ， 单 位 是 赫兹 (Hz) 。 例 如 ， 从 原 
声 吉他 的 第 三 根 弦 产生 音符 D， 频 率 是 146.83 医 
北 。 可 以 在 计算 机 上 创建 频率 为 146.83 Hz 的 正弦 
波 ， 来 模拟 这 种 声音 ， 如 图 4-1 所 示 。 


TRH ce, SORE HL ER BOR IE SZ, 
听 起 来 不 会 像 吉 他 或 钢琴 。 播 放 相 同 的 音符 时 ， 是 
什么 让 计算 机 的 声音 与 乐 右 如 此 不 同 呢 ? 


在 言 他 上 拨 弦 时 ， 乐 磺 产 生 了 不 同 强度 的 混合 











频率 ， 如 图 4-2 的 频谱 图 所 示 。 刚 拨 嘴 时 声音 最 
强 ， 强 度 随 痢 时 间 推 移 而 逐渐 消失 。 拨 动 言 他 D 纺 
听 到 的 主要 频 京 称 为 基本 频 紊 ， 是 146.83 赫 效 ， 但 
也 会 听 到 该 频率 的 一 些 倍数 ， 称 为 泛音 。 任 何 乐 右 
的 声 首都 由 这 种 基本 频率 和 泛音 组 成 ， 正 是 这 种 组 
合 ， 让 吉他 听 起 来 像 吉 他 。 


如 你 所 见 ， 在 计算 机 上 模拟 拨 弱 乐句 的 声音 ， 
要 能 同时 生成 基本 频率 和 泛音 。 诀 穷 是 利用 
Karplus-Strong 算 法 。 


这 个 项 目 使 用 Karplus-Strong 算 法 ， 产 生 5 个 类 
似 言 他 的 音符 ， 它 们 属于 一 个 音阶 《一 系列 相关 的 
音符 ) 。 我 们 会 让 产生 这 些 音符 的 算法 可 视 化 ， 并 
将 声音 保存 为 WAV 文 件 。 我 们 还 会 创建 一 种 方 
式 ， 随 机 演奏 它们 ， 并 学 习 如 何 做 到 以 下 几 点 : 

















。 用 Python 的 deque 类 实现 环形 缓冲 区 : 
。 使 用 numpy 数 组 和 ufuncs; 

。 用 pygame 播 放 WAV 文 件 ; 

。 用 matplotlib 绘 

RSS BE. 


TIT 
tu 


图 4-1 146.83 Hz 的 正弦 波 








图 4-2 ”吉他 上 弹 奏 音符 D4 的 频谱 图 


除了 用 Python 实现 Karplus-Strong 算 法 ， 我 们 还 
会 探讨 WAV 文 件 格式 ， 看 看 如 何 产生 五 声音 阶 中 
的 音符 。 


4.1 工作 原理 


利用 偏 移 值 构成 的 环形 绥 冲 区 ， 模 拟 两 端 固定 
的 弦 ， 类 似 于 吉他 弦 ，Karplus-Strong 算 法 可 以 模拟 
拨 弱 的 声音 。 

环形 绥 冲 区 (也 称 为 循环 绥 冲 区 )〉 是 一 个 固定 
KEBAK ORAH) ， 但 折返 到 本 丑 。 
换言之 ， 如 果 到 达 绥 冲 区 的 末尾 ， 则 下 一 个 元 系 束 
是 缓冲 区 的 第 一 个 元 素 ( 坏 缓冲 区 的 更 多 信息 ， 参 
见 4.3.1 小 节 ) © 


根据 公式 N=S / f， 环 形 绥 冲 区 的 长 上 度 (MD 5 
振动 的 基本 频 紊 有关， 其 中 Ss 是 采样 紊 ，f 是 频率 。 

模拟 开始 时 ， 绥 冲 区 中 填充 一 些 随机 值 ， 旋 围 
在 [-0.5，0.5]， 可 以 认为 代表 了 拨 弦 在 振动 时 的 随 
机 偏 移 。 

除了 环形 缓冲 区 ， 可 以 用 一 个 样本 缓冲 区 ， 保 
存 任何 特定 时 间 的 声音 强度 。 这 个 缓冲 区 的 长 度 和 
采样 率 决 定 了 声音 片段 的 长 度 。 
4.1.1 模拟 

模拟 持续 进行 ， 直 到 样本 绥 冲 填充 了 一 种 反馈 





方案 ， 如 图 4-3 所 示 。 对 于 模拟 的 每 一 步 ， 做 以 下 
几 件 事 : 
本 1. 将 环形 缓冲 区 的 第 一 个 值 存 入 样本 绥 冲 
2. 计算 环形 绥 冲 区 前 两 个 元 素 的 平均 值 ; 
3. 平均 值 乘 以 一 个 衰减 系数 〈 在 这 个 例子 
中 ， 是 0.995) ; 
4. 将 该 值 添 加 到 环形 缕 冲 区 的 末尾 ; 
5. 移 除 环形 绥 冲 区 的 第 一 个 元 叉 。 
样本 缓冲 区 


t. 






环形 缓冲 区 
eE] 


| 均值 *0.995 ] 


图 4-3 ”环形 缓冲 区 和 Karplus-Strong 算 法 


为 了 模拟 拨 弦 ， 在 坏 形 缓冲 区 填 入 一 些 数 字 ， 
代表 波 的 能 量 。 样 本 缓冲 区 表示 最 终 的 声 首 数 据 ， 
通过 友 代 通 历 环 形 缓冲 区 中 的 值 来 创建 。 使 用 平均 
方案 “等 一 下 解释 ) 来 更 新 环形 缓冲 区 的 值 。 


这 种 反馈 方案 旨 在 模拟 能 量 通过 一 根据 动 的 
5A. MEET, OARS, SERE 
它 的 长 度 成 反比 。 因 为 我 们 感 兴 趣 的 是 产生 一 定 频 
率 的 声 首 ， 所 以 选择 一 个 环形 缓冲 区 ， 其 长 有 度 与 该 
频率 成 反比 。 模 拟 第 1 步 的 求 平均 值 相当 于 “ 低 通 渡 
波 各 ”， 切 靳 较 吕 频率， 并 允许 较 低 频率 通过 ， 从 
而 消除 高 次 谐 波 《〈 即 基 频 的 较 大 倍数 ) ， 因 为 我 们 
的 主要 兴趣 是 基 频 。 最 后 ， 用 衰减 因 了 于 来 模拟 波 洛 
AIAR EREE EMRK o 


模拟 第 1 步 中 用 到 的 样本 缓冲 区 ， 表 示 产 生 的 
声音 随时 间 变 化 的 振幅 。 为 了 计算 任何 给 定 的 振 
幅 ， 需 要 计算 环形 缓冲 区 前 两 个 元 系 的 平均 值 ， 结 
东 乘 以 袁 减 系数 ， 更 新 环形 缓冲 区 。 这 个 计算 的 值 
被 请 加 到 环形 缓冲 区 的 末尾 ， 并 删除 第 一 个 元 妹 。 

现在 ， 我 们 来 看 看 该 算法 执行 的 一 个 简单 例 
子 。 下 表 表 示 两 个 连续 时 间 步 又 的 环形 缓冲 区 。 环 
形 缓冲 区 中 的 每 个 值 表 示 声 普 的 振幅 。 该 绥 冲 区 具 
有 5 个 元 素 ， 它 们 开始 填充 了 一 些 数字 。 


mm 





























bond "n |... |. 


时 间 步 又 2 0.199 


从 第 1 步 转 到 第 2 步 ， 像 这 样 应 用 Karplus- 
Strong 算 法 。 第 一 行 的 第 一 个 值 0.1 被 删除 ， 第 1 步 
中 所 有 后 续 值 以 相同 顺序 加 入 第 2 行 ， 它 表示 时 间 
上 的 第 2 步 。 第 2 步 的 最 后 一 个 值 是 第 1 步 的 第 一 个 
值 和 最 后 一 个 值 的 隧 减 平均 值 ， 计 算 方法 是 
0.995x ( (0.1+ -0.5) +2) = —0.199. 


4.1.2 创建 WAV 文 件 


波形 音频 文件 格式 (WAV) 用 于 存储 音频 数 
据 。 这 种 格式 对 小 的 首 乐 项 目 比 较 方 便 ， 因 为 它 简 
单 ， 不 需要 处 理 复杂 的 压缩 技术 。 


在 最 简单 的 形式 中 ，WAV 文 件 由 一 系列 比特 
构成 ， 表 示 在 给 定时 间 点 所 记录 的 声音 的 振幅 ， 称 
为 分 辨 率 。 本 项 目 中 使 用 16 位 分 辨认 。WAV 文 件 
也 有 一 组 采样 率 ， 是 音频 每 秒 采 样 或 读 取 的 次 数 。 
本 项 目 采 用 44100 区 兹 ， 即 CD 中 使 用 的 采样 率 。 让 
我 们 用 Python 产 生 5 秒 的 220 Hz 正弦 波音 频 片 段 。 首 
先 ， 用 这 个 公式 表示 正弦 波 : 


A = sin (2nft ) 














SH, AZAKI, PERK, te SHY 
间 的 索引 。 现 在 ， 重 写 这 个 公式 如 下 : 


A = sin (2nfi/R) 


在 这 个 公式 中 ，i 是 样本 的 索引 ，R 是 采样 率 。 
用 这 两 个 方程 ， 可 以 按 如 下 方 ee 
的 正弦 波 WAV 文 件 : 








import numpy as np 
import wave, math 
sRate = 44100 
nsamples = = sRate * 

6 x = "p. arange(nsanples)/float(sRate) 

vals - np.sin(2.0*math.pi*220.0*x) 

@ data = np.array(vals*32767, 'int16' BE tostring() 
file = wave.open('sine220.wav', 'w 

© file.setparams((1, 2, sRate, nSamples, 'NONE', ‘uncompress 
file.writeframes(data) 
file.close() 


在 @@ 行 和 人 人行 ， 根 据 第 二 个 正弦 波 方程 ， 创 建 
振幅 值 的 numpy 数 组 ( 见 第 1 草 ) 。 对 数组 应 用 函 
数 ， 如 sin() 函 数 ，numpy 数 组 是 快速 、 便 捷 的 方 


Ae 


在 信行 ， 计 算 好 的 、 在 [-1，1] 范 围 的 正弦 波 值 
被 放大 为 16 位 值 ， 并 转换 成 字符 串 ， 以 便 写 入 文 
件 。 在 2. 为 WAV 文 件 设置 参数 ， 在 这 个 例子 
中 ， 是 单 通道 ( 单 声 道 ) 、 两 字 节 〈16 位 ) 、 无 压 


缩 的 格式 。 图 4-4 展 示 了 生成 的 sine220.wav 文 件 在 
Audacity F H]FE-T^, Audacitye — 3X He P EH] Er 2902 
Hum. IEA ASE, RATEI S A220724 
的 正弦 波 ， 如 采 播 放 该 文件， 会 听 到 5 秒 的 220 Hz 
音调 。 












































- Project Rate (Hz): Selection Start: (End ( / Length Audio Position: 
: 44100 ® | Snap To 00h00 m 00.000” 00h 00 m 05.000 sr | 00h 00 m 00.000 sr 








Click to Zoom In, Shift-Click to Zoom Out 


Actual Rate: 44100 Á4 


图 4-4 220 Hz 的 正弦 波 
441.3 小调 五 声音 阶 


“音阶 ?是 一 系列 升 高 或 降低 音 高 〈 频 率 ) 的 音 
符 。 < 音 Efe PAPER ed ZBI A Ze 通常， mo 
的 所 有 音符 都 从 特定 音阶 中 选择 。 “半音 ?是 音阶 的 








基本 单位 ， 是 西方 音乐 最 小 的 音程 。 全 音 是 半音 长 
度 的 两 倍 。“ 大 调 音 阶 ”是 最 常见 的 一 种 音阶 ， 间 隐 
模式 是 “全 音 -全 音 -半音 -全 音 -全 音 -全 音 -半音 ”。 


这 里 ， 我 们 将 快速 进入 五 声 首 阶 ， 因 为 我 们 要 
产生 这 个 音阶 的 音符 。 本 节 将 告诉 你 ， 我 们 如 何 得 
出 程序 中 用 到 的 频率 数字 ， 利 用 Karplus-Strong 算 法 
来 生成 这 些 音 符 。 “五 声音 阶 ? 是 五 个 音符 的 音阶 。 
例如 ， 美 国 兰 名 的 歌曲 “Oh! Susanna” 束 是 基于 五 声 
首 阶 的 。 这 种 首 阶 的 一 个 变种 是 小 调 五 声 首 阶 。 


这 种 首 阶 定义 为 首 和 从 序列 “(全 首 + 半 首 ) -全 
音 - 全 音 -〈 全 音 + 半 音 ) -全 音 ”。 因 此 ，C 小 调 五 声 
音阶 包含 音符 C、 降 E、F、G 和 降 B。 表 4-1 列 出 了 
小 调 五 声音 阶 中 5 个 音符 的 频率 ， 我 们 将 用 Karplus- 
Strong 算 法 来 产生 它 OXE, CARIA REAA 
上 度 的 C， 或 习惯 称 为 中 音 C) 。 


表 4-1 小 调 五 声音 阶 的 音符 
































4.2 ”所 需 模 块 


本 项 目 将 用 Python 的 wave 模 块 来 创建 WAV 格 
式 的 音频 文件 。 使 用 numpy 数 组 来 实现 Karplus- 
Strong 算 法 ， 用 Python 集合 中 的 deque 类 来 实现 环形 
缓冲 区 。 还 会 用 pygame 模 块 来 播放 WAV 文 件 。 


43 ”代码 


现在 ， 让 我 们 开发 实现 Karplus-Strong 算 法 所 
需 的 各 种 代码 片段 ， 然 后 将 它们 合并 成 完整 的 程 
序 。 要 查看 完整 的 项 目 代 码 ， 请 直接 跳 到 4.4 节 。 


4.3.1 用 deque 实 现 环 形 缓冲 区 


回想 一 下 ， 前 面 提 到 Karplus-Strong 算 法 使 用 
环形 缓冲 区 来 生成 一 个 音符 。 我 们 将 利用 Python 的 
dequeZiz& (ARE A“deck”, zéPythonfcollections 
模块 的 一 部 分 )， 来 实现 环形 缓冲 区 ， 它 用 一 个 数 
组 提供 了 专门 的 容器 数据 类 型 。 可 以 从 deque 的 开 
ta (Sk) RRE OC) 插入 或 删除 元 素 〈 见 网 4- 
5) 。 这 种 插入 和 删除 过 程 是 O(1) 或 “常数 时 间 ” 的 操 
TE; 这 意味 着 不 论 deque 的 容器 变 得 多 大 ， 它 需 要 
的 时 间 都 是 相同 的 。 





popleftl append| 
ON OU 


图 4-5 “使 用 deque 的 环形 缓冲 区 


下 面 的 代码 展示 了 如 何在 Python 中 使 用 
deque: 


>>> from collections import deque 
@ >>> d = deque(range(10)) 

>>> print(d) 

deque([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]) 
© >>> d. append ( - 1) 


® >>> a popleft() 
0 


>>> print d 


deque([1, 2, 3, 4, 5, 6, 7, 8, 9, -1]) 


在 代行 ， 传 入 range0) 方 法 创建 的 一 个 列表 ， 创 
建 了 deque 容 器 。 在 从 行 ， 将 一 个 元 系 添 加 到 deque 
RAKE, fre. 从 deque 的 头 部 弹出 HH 
除 ) 第 一 个 元 素 。 这 两 个 操作 都 很 快 。 


4.3.2 ”实现 Karplus-Strong 算 法 


也 可 以 用 deque 容 器 ， 人 针对 环形 缕 冲 区 ， 实 现 
Karplus-Strong 算 法 ， 如 下 所 示 : 





# generate note of given frequency 
def generateNote(freq): 
nSamples - 44100 
sampleRate - 44100 
N = int(sampleRate/freq) 
# initialize ring buffer 
buf - deque([random.random() - 0.5 for i in range(N)]) 
# initialize samples buffer 
samples = np.array([0]*nSamples, 'float32') 
for i in range(nSamples): 
samples[i] = buf[0] 
avg = 0.996*0.5*(buf[0] + buf[1]) 
buf.append(avg) 
buf.popleft() 


eo © © 


# convert samples to 16-bit values and then to a string 
# the maximum value is 32767 for 16-bit 

® samples = np.array(samples*32767, 'int16') 

O return samples.tostring() 


在 @ 行 ， 用 范围 在 [-0.5，0.5] 的 随机 数 来 初始 
化 deque。 在 信行 ， 建 立 一 个 浮 点 数组 来 保存 声音 


采样 。 该 数组 的 长 度 与 采样 率 相符 ， 这 意味 看 将 生 
成 一 秒 钟 的 声 首 片 段 。 


在 仍 行 ，deque 的 第 一 个 元 素 被 复制 到 采样 绥 
冲 区 。 在 @ 行 和 随后 几 行 中 ， 可 以 看 到 低 通 滤波 器 
和 衰减 在 生效 。 在 @ 行 ，samples 数 组 的 每 个 值 乘 以 
32767 (16 位 市 从 号 整数 的 取 值 范围 是 一 32768~ 
32,767) ， 被 转换 成 16 位 的 格式 。 在 @ 行 ， 它 被 转 
换 成 字符 串 表 示 形 式 ， 这 是 wave 模 块 的 要 求 ， 我 们 
将 用 该 模块 ， 将 这 些 数据 保存 到 文件 。 


4.3.3” 写 WAV 文 件 


拥有 首 频 数据 后 ， 可 以 用 Python 的 wave 模 块 ， 
将 其 写 和 WAV 文件。 

















def writewAVE(fname, data): 
# open file 
@ file = wave.open(fname, 'wb') 
# WAV file parameters 
nChannels = 1 
samplewidth = 2 
frameRate = 44100 
nFrames = 44100 
# set parameters 


file. setparams((nChannels, samplewidth, frameRate, nFrames, 
NONE', 'noncompressed')) 
® file.writeframes(data) 
file.close() 


在 @ 行 ， 创建 了 一 个 WAV 文 件 ， 在 信行 ， 将 





参数 设置 为 使 用 单 声 道 、16 位 、 无 压缩 的 格式 。 最 
后 ， 在 信行， 将 数据 写 入 文件 。 


43.4 ”用 pygame 播 放 WAV 文 件 


现在 ， 用 Python 的 pygame 模 块 播 放 算 法 生成 的 
WAV 文 件 。pygame 是 用 来 编写 游戏 的 流行 Python 
模块 。 它 基于 简单 直接 媒体 层 (SDL) 库 ， 该 库 是 
高 性 能 的 底层 库 ， 让 你 能 访问 声音 、 图 形 ， 以 及 计 
算 机 的 输入 设备 。 


方便 起 见 ， 我 们 将 代码 封装 在 NotePlayer 类 
中 ， 如 下 所 示 : 











# play a WAV file 
class NotePlayer: 
# constructor 
def _ init (self): 
e pygame.mixer.pre init(44100, -16, 1, 2048) 
pygame.init() 
# dictionary of notes 
eo self.notes = {} 
# add a note 
def add(self, fileName): 
e self.notes[fileName] - pygame.mixer.Sound(fileName) 
# play a note 
def play(self, fileName): 
try: 


y: 
o self.notes[fileName].play() 
except: 
print(fileName + ' not found!') 
def playRandom(self): 
"""play a random note""" 
® index = random.randint(0, len(self.notes)-1) 
Q note - list(self.notes.values())[index] 
note.play() 


在 代行 ， 预 先 初始 化 pygame 的 mixer 类 : 44100 
的 采样 紊 ，16 位 的 有 符号 值 ， 单 声 道 ， 绥 冲 区 大 小 
为 2048。 在 信行 ， 创 建 一 个 音符 的 字典 ， 它 针对 文 
件 名 保存 pygame 的 声 首 对 象 。 接 下 来 ， 在 
NotePlayer 的 add0) 方 法 中 合 ， 创 建 声 首 对 象 ， 并 将 
它 保存 在 notes 目 录 中 。 


请 注意 ， 在 play0 中 人 @ 行 如 何 使 用 目录 ， 并 播 
放 与 文件 名 相关 联 的 声音 对 象 。playRandom0 方 法 
从 已 生成 的 五 个 音符 中 随机 选取 一 个 播放 。 最 后 ， 
在 全 行 ，randint0) 从 范围 [0,4] 中 选择 一 个 随机 整 
数 ， 在 全 行 从 字典 中 挑选 一 个 音符 播放 。 


43.5 ”main() 方 法 


现在 看 看 main() 方 法 ， 它 创建 首 从 并 处 理 各 种 
ASAT ED, WEE TT 


parser = argparse.ArgumentParser(description="Generating soun 
Karplus String Algorithm" ) 
# add arguments 
@ parser.add_argument('-- 
display', action='store_true', required=False) 
parser .add_argument(' - - 
play', action='store_true', required=False) 
parser .add_argument(' - - 
piano', action='store_true', required=False) 
args = parser.parse_args() 


# show plot if flag set 

if args.display: 
gShowPlot = True 
plt.ion() 


# create note player 
nplayer - NotePlayer() 


print('creating notes...') 
for name, freq in list(pmNotes.items()): 
fileName = name + '.wav' 
(2) if not os.path.exists(fileName) or args.display: 
data = generateNote(freq) 
print('creating ' + fileName + '...') 
writeWAVE(fileName, data) 
else: 
print('fileName already created. skipping...') 


# add note to player 
e nplayer.add(name + '.wav') 


# play note if display flag set 
if args.display: 
o nplayer.play(name + '.wav') 
time.sleep(0.5) 


# play a random tune 
if args.play: 
while True: 


try: 
® nplayer.playRandom( ) 
# rest - 1 to 8 beats 
Q rest = np.random.choice([1, 2, 4, 8], 1, 


p-[0.15, 0.7, 0.1, 0.05]) 
time.sleep(0.25*rest[0]) 
except KeyboardInterrupt: 
exit() 


首先 ， 用 argparse 为 程序 建立 一 些 命 令 行 选 
项 ， 束 像 以 前 的 项 目 中 讨论 的 一 样 。 在 @@ 行 ， 如 果 
使 用 了 --display 命 令 行 选项 ， 就 用 matplotlib 绘 图 ， 
显示 Karplus-Strong 算 法 中 波形 如 何 演变 。ion0O 调 用 
启动 了 matplotlib 的 交互 模式 。 然 后 ， 创 建 
NotePlayer 类 的 一 个 实例 ， 用 generateNote() 方 法 生 











成 五 声音 阶 的 音符 。 五 个 音符 的 频率 在 全 局 字典 
pmNotes 中 定义 。 


在 信行 ， 利 用 os.path.exists() 方 法 来 查看 WAV 
文件 是 否 已 创建 。 如 果 已 创建 ， 就 跳 过 计算 (如 果 
多 次 运行 该 程序 ， 这 是 一 个 方便 的 优化 ) 。 


计算 好 音符 、 创 建 了 WAV 文 件 后 ， 在 @ 行 将 
该 首 和 从 添加 NotePlayer 字 上 典 中 ， 如 果 使 用 了--display 
fp XS. Wurf m. 


在 全 行 ， 如 果 使 用 了 --play 选 项 ，NotePlayer 的 
prr ee 残 从 五 个 音符 中 随机 播放 一 个 首 

。 要 让 一 个 音符 序列 听 起 来 更 像 音 乐 ， 需 要 在 播 
iit ATL IRASAARIETE, MUET, Hinumpy 
模块 的 random.choice() 方 法 ， 选 择 随机 的 休止 时 
间 。 访 方法 还 可 以 选择 休止 间隔 的 概率 ， 设 置 之 后 
可 以 让 两 拍 的 休止 最 有 可 能 ， 八 拍 的 休止 最 不 可 
能 。 请 试 着 改变 这 些 值 ， 以 创建 自己 的 音乐 风格 ! 








44 完整 代码 


现在 将 程序 整合 在 一 起 。 完 整 的 代码 如 下 ， 也 
Hy LA Mhttps://github.com/electronut/ 
pp/blob/master/karplus/ks.py F 4X. 


import sys, os 

import time, random 

import wave, argparse, pygame 

import numpy as np 

from collections import deque 

from matplotlib import pyplot as plt 


# show plot of algorithm in action? 
gShowPlot - False 


# notes of a Pentatonic Minor scale 
# piano C4-E(b)-F-G-B(b)-C5 
pmNotes = ('C4': 262, 'Eb': 311, 'F': 349, 'G':391, 'Bb':466} 
# write out WAV file 
def writeWAVE(fname, data): 

# open file 

file = wave.open(fname, 'wb') 

# WAV file parameters 

nChannels = 1 

samplewidth = 2 

frameRate = 44100 

nFrames = 44100 

# set parameters 


file.setparams((nChannels, samplewidth, frameRate, nFrames, 
'NONE', 'noncompressed')) 
file.writeframes(data) 
file.close() 


# generate note of given frequency 
def generateNote(freq): 
nSamples - 44100 


sampleRate = 44100 
N - int(sampleRate/freq) 
# initialize ring buffer 
buf - deque([random.random() - 0.5 for i in range(N)]) 
# plot of flag set 
if gShowPlot: 
axline, - plt.plot(buf) 
# initialize samples buffer 
samples - np.array([0]*nSamples, 'float32') 
for i in range(nSamples): 
samples[i] = buf[0] 
avg = 0.995*0.5*(buf[0] + buf[1]) 
buf.append(avg) 
buf.popleft() 
# plot of flag set 
if gShowPlot: 
if i % 1000 == 0: 
axline.set_ydata(buf) 
plt.draw() 


# convert samples to 16-bit values and then to a string 
# the maximum value is 32767 for 16-bit 
samples = np.array(samples*32767, 'int16') 
return samples.tostring() 
# play a WAV file 
class NotePlayer: 
# constructor 
def _ init__(self): 
pygame.mixer.pre_init(44100, -16, 1, 2048) 
pygame.init() 
# dictionary of notes 
self.notes = {} 
# add a note 
def add(self, fileName): 
self.notes[fileName] - pygame.mixer.Sound(fileName) 
# play a note 
def play(self, fileName): 
try: 
self.notes[fileName].play() 
except: 
print(fileName + ' not found!') 
def playRandom(self): 
"""play a random note""" 
index = random.randint(0, len(self.notes)-1) 
note - list(self.notes.values())[index] 
note.play() 


# main() function 


def main(): 
# declare global var 
global gShowPlot 


parser = argparse.ArgumentParser(description="Generating soun 
Karplus String Algorithm") 
# add arguments 
parser.add argument('-- 
display', action-'store true', required=False) 
parser.add argument('-- 
play', action-'store true', required-False) 
parser.add argument('-- 
piano', action-'store true', required-False) 
args - parser.parse args() 


# show plot if flag set 

if args.display: 
gShowPlot - True 
plt.ion() 


# create note player 
nplayer - NotePlayer() 


print('creating notes...') 
for name, freq in list(pmNotes.items()): 
fileName = name + '.wav' 
if not os.path.exists(fileName) or args.display: 
data - generateNote(freq) 


print('creating ' + fileName + '...') 
writeWAVE(fileName, data) 

else: 
print('fileName already created. skipping...') 


# add note to player 
nplayer.add(name + '.wav') 


# play note if display flag set 

if args.display: 
nplayer.play(name + '.wav') 
time.sleep(0.5) 


# play a random tune 
if args.play: 
while True: 
try: 
nplayer.playRandom() 
# rest - 1 to 8 beats 


rest = np.random.choice([1, 2, 4, 8], 1, 
p-[0.15, 0.7, 0.1, 0.05]) 
time.sleep(0.25*rest[0]) 
except KeyboardInterrupt: 
exit() 


# random piano mode 
if args.piano: 
while True: 
for event in pygame.event.get(): 
if (event.type -- pygame.KEYUP): 

print("key pressed") 
nplayer.playRandom() 
time.sleep(0.5) 


# call main 
if _name__ == ' main ': 
main() 


4.5 ”运行 拨 弦 模拟 


要 运行 这 个 项 目的 代码 ， 束 在 命令 行 输入 : 


$ python3 ks.py -display 





matplotlib 绘 图 展示 了 Karplus-Strong 算 法 如 何 
转换 初始 随机 偶 移 ， 创 建 所 需 频 率 的 波 ， 如 图 4-6 
所 示 。 


Python 一 80x40 A mahesh 
moksha:karplus mahesh$ python ks.py --display moksha;~ mahesh$ 
creating notes... 
creating F.wav... 
creating Eb.wav.. 
creating Bb.wav.. Bm Figure 1 
creating G.wav... 





TO 0+" 6s 





图 4-6 ”Karplus-Strong 算 法 的 运行 示例 
现在 尝试 用 这 个 程序 播放 随机 首 符 。 


$ python ks.py -play 


这 应 该 会 用 + 四 人 — rm 1 
RET 生成 的 五 声音 阶 WAV 文 件 播放 随 


4.6 小结 


这 个 项 目 用 Karplus-Strong 算 法 来 模拟 拨 弱 的 
声音 ， 利 用 生成 的 WAV 文 件 来 播放 音符 。 





47 实验 


这 里 有 一 些 值得 试验 的 想法 : 


1. 用 你 在 本 章 学 到 的 技术 创建 一 种 方法 ， 午 
现 两 根 不 同 频率 的 弦 一 起 振动 友 出 的 声 首 。 记 住 ， 
Karplus-Strong 算 法 产生 的 声 首 振幅 可 以 车 加 (放大 
到 16 位 值 并 生成 WAV 文 件 之 前 ) 。 现 在 ， 在 第 一 
次 拨 强 和 第 二 次 拨 弦 之 间 增 加 一 点 延 时 。 


2. 写 一 个 方法 ， 从 文本 文件 中 读 取 首 乐 ， 并 
生成 音符 。 然 后 用 这 些 音符 播放 音乐 。 使 用 的 格式 
可 以 是 音符 名 称 后 面 跟 上 整数 的 休止 时 间 ， 就 像 这 
FÉ: C41F42G41...... 

3. 为 项 目 添 加 --piano 命 令 行 选 项 。 如 果 程 序 
用 这 个 选项 运行 ， 用 户 应 该 能 够 按键 盘 上 的 A、S、 
D、F 和 G 键 ， 播 放 五 个 音符 (提示 : 用 
pygame.event.getfllpygame.event.type) . 
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仔细 观察 一 群 乌 或 一 群 鱼 ， 你 会 发 现 ， 虽 然 群 
体 由 个 体 生 物 组 成 ， 但 该 群体 作为 一 个 整体 似乎 有 
它 目 己 的 生命 。 马 群 中 的 乌 在 移动 、 飞 越 和 绕 过 障 
得 物 时 ， 彼 此 之 间 相 互 定位 。 受 到 打扰 或 惊吓 时 会 
破坏 编队 ， 但 随后 重新 集结 ， 仿 佛 被 东 种 更 大 的 力 


量 控制 。 


1986 年 ，Craig ”Reynolds 创 造 乌 类 群体 行为 的 
一 种 逼真 模拟 ， 称 为 “类 乌 群 (Boids) RM. KF 
类 乌 群 模型 ， 值 得 注意 的 是 ， 只 有 3 个 简单 的 规则 
控制 看 群体 中 个 体 间 的 相互 作用 ， 但 该 模型 产生 的 
行为 类 似 于 真正 的 乌 群 。 类 乌 群 模型 被 广泛 研究 ， 








其 至 被 用 来 制作 群体 的 计算 机 动画 ， 如 电影 “ 蝙 晤 
使 归来 (1992) "REST AE ARE 





本 项 目 将 利用 Reynolds 的 3 个 规则 ， 创 建 一 个 
类 乌 群 ， 模 拟 N 只 乌 的 群体 行为 ， 并 画 出 随 着 时 间 
的 推移 ， 它 们 的 位 置 和 运动 方向 。 我 们 还 会 提供 一 
个 方法 ， 回 鸟 群 中 添加 一 只 鸟 ， 以 及 一 种 驱散 效 
果 ， 可 以 用 于 研究 群体 的 局 部 干扰 效果 。 类 鸟 群 被 
称 为 “N 体 模拟 *”"， 因 为 它 模拟 了 NN 个 粒子 的 动态 系 
统 ， 彼 此 之 间 施 加 作用 力 。 


5.1 工作 原理 


模拟 类 马 群 的 三 大 核心 规则 如 下 : 
DA: 保持 关 马 个 体 之 间 的 最 小 距离 ; 


列队 : 让 每 个 类 鸟 个 体 指向 其 局 部 同伴 的 平均 
移动 方向 ; 
E 让 每 个 类 鸟 个 体 朝 其 局 部 同伴 的 质量 中 


类 马 群 模拟 也 可 以 添加 其 他 规则 ， 如 如 开 障 但 
物 ， 或 受到 打扰 时 驱散 马 群 ， 在 随后 的 小 节 中 我 们 
将 会 探讨 这 些 。 这 个 版 本 的 类 马 群 在 模拟 的 每 一 步 
中 ， 实 现 了 这 些 核心 规则 。 


。 对 于 群体 中 的 所 有 类 马 个 体 ， 做 以 下 几 件 事 : 
。 应 用 三 大 核心 规则 ; 
。 应 用 所 有 附加 规则 ，; 
。 应 用 所 有 边界 条 件 。 

。 更 新 类 乌 个 体 的 位 置 和 速度 。 

。 绘制 新 的 位 置 和 速度 。 


如 你 所 见 ， 这 些 简 单 的 规则 创造 了 一 个 马 群 ， 





它 具 有 演变 的 复杂 行为 。 


5.2 ”所 需 模块 


下 面 是 该 模拟 要 用 到 的 Python 工具 : 





numpy 数 组 ， 用 于 保存 类 乌 群 的 位 置 和 速度 ; 
matplotlib 库 ， 用 于 生成 类 乌 群 动画 ; 

argparse， 用 于 处 理 命令 行 选项 ; 
scipy.spatial.distance 模 块 ， 包 含 一 些 非常 侧 洁 的 
方法 ， 计 算 扣 之 则 的 距离 。 


对 类 鸟 群 项 目 ， 我 选择 使 用 matplotlib， 是 为 了 简单 和 方便 。 要 
尽 可 能 快 地 绘制 数量 庞大 的 类 乌 群 ， 可 能 会 使 用 类 似 OpenGL 这 样 
的 库 。 本 书 的 第 三 部 分 将 详细 探讨 图 形 。 


5.3 ”代码 


首先 ， 要 计算 类 乌 群 的 位 置 和 速度 。 接 下 来 ， 
要 为 模拟 设置 边界 条 件 ， 看 看 如 何 绘制 类 乌 群 ， 并 
实现 前 面 讨 论 的 类 乌 群 模拟 规则 。 最 后 ， 我 们 会 为 
模拟 添加 一 些 有 趣 的 事件 ， 即 添加 一 些 类 乌 个 体 和 
驱散 类 乌 群 。 要 查看 完整 的 项 目 人 代码， 请 直接 跳 到 
5.47 


5.3.1 计算 类 乌 群 的 位 置 和 速度 

类 鸟 群 仿真 需要 从 numpy 数 组 取得 信息 ， 计 算 
每 一 步 中 类 鸟 群 个 体 的 位 置 和 速度 。 模 拟 开 始 时 ， 
将 所 有 类 乌 群 个 体 大 致 放 在 屏幕 中 央 ， 速 度 设 置 为 
BED LIS Tz In] © 





@ import math 
€ import numpy as np 


® width, height = 640, 480 
© pos = [width/2.0, height/2.0] + 10*np.random.rand(2*N).resl 


® angles = 2*math.pi*np.random.rand(N) 
vel - np.array(list(zip(np.sin(angles), np.cos(angles)))) 


开始 在 @ 行 导入 math 模 块 ， 用 于 接 下 来 的 计 
算 。 在 傅 行 ， 将 numpy 库 导入 为 np〈 少 一 些 录 





A) 。 然 后 ， 设 置 屏 幕 上 模拟 窗口 的 宽度 和 高 度 
人 .在 @@ 行 ， 创 建 一 个 numpy 数 组 pos， 对 窗口 中 心 
加 上 10 个 单位 以 内 的 随机 偏 移 。 代 码 
np.andom.rand (2 * NO 创建 了 一 个 一 维 数组 ， 包 
舍 范 围 在 [0，1] 的 2N 个 随机 数 。 然 后 reshapeO 调 用 
将 它 转 换 成 二 维 数组 的 形状 ON. 220 ， 它 将 用 于 你 
存 类 乌 群 个 体 的 位 置 。 也 要 注意 ，numpy 的 广播 规 
1x2 的 数组 加 到 Nx2 的 数组 的 每 个 
was 


接 下 来 ， 用 以 下 方法 ， 创 建 随机 单位 速度 矢量 
数组 〈 这 些 都 是 模 为 1.0 的 矢量 ， 指 向 随机 的 方 
MA): 给 定 一 个 角度 t， 数 字 对 (cos(t)，sin(t)) 位 于 半 
径 为 1.0 的 圆 上 ， 中 心 在 原点 (0， 0)。 如 果 从 原点 到 
圆 上 的 一 点 画 一 条 线 ， 就 得 到 一 个 单位 矢量 ， 它 取 
决 于 角度 A。 如 果 随 机 选择 角度 A， 束 得 到 一 个 随 
机 速度 矢量 。 图 5-1 展 示 了 这 个 方案 。 















(cos[t2], sinlt2) icos[tl , sint] 


图 5-1 随机 生成 单位 速度 矢量 


在 信行 ， 生 成 一 个 数组 ， 包 含 N 个 随机 角度 ， 
范围 在 [0，2pi， 在 @@ 行 ， 用 前 面 讨论 的 随机 回 量 方 
法 生成 一 个 数组 ， 并 用 内 置 的 zip0 方 法 将 坐标 分 
组 。 这 里 有 zipO 的 一 个 简单 例子 。 它 将 两 个 列表 合 
并 成 一 个 元 组 的 列表 。 


>>> zip([0, 1, 2], [3, 4, 5]) 
[(0, 3), (1, 4), (2, 5)] 





这 里 ， 生 成 了 两 个 数组 ， 一 个 包含 随机 的 位 
畦 ， 聚 集 在 屏 大 中 心 10 像 系 的 半径 范围 内 ， 力 一 个 
包含 随机 方 回 的 单位 速度 。 这 意味 着 在 模拟 开始 
时 ， 类 马 群 盘旋 在 屏 筑 中 心 ， 指 同 随机 的 方 问 。 


5.3.2 ”设置 边界 条 件 


马 儿 飞翔 在 无 际 的 天 空 ， 但 类 乌 群 必须 在 有 限 
的 空间 中 运动 。 要 创建 这 个 空间 ， 束 要 创建 边界 条 
件 ， 就 像 第 3 章 中 为 Conway 模 拟 创建 环形 边界 条 件 
一 样 。 在 这 个 例子 中 ， 我 们 采用 "“ 平 铺 小 块 边 界 条 
a 
BUR. 
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如 果 类 马 群 个 体 离开 一 个 小 块 ， 它 将 从 相反 的 方 问 

















进入 到 相同 的 小 块 。 环 形 边界 条 件 和 小 块 边界 条 件 
之 间 的 主要 区 别 是 ， 类 乌 群 模拟 不 会 发 生 在 离散 的 
网 格 上 ， 而 是 在 一 个 连续 区 域 移动 。 图 5-2 展 示 了 
这 些小 块 边界 条 件 的 样子 。 请 看 图 5-2 中 间 的 小 
块 。 飞 出 右 侧 的 鸟 儿 正 进入 右边 的 小 块 ， 但 该 边界 
条 件 确保 它们 实际 上 通过 平 铺 在 左边 的 小 块 ， 叉 回 
到 了 中 心 的 小 块 。 在 顶部 和 底部 的 小 块 ， 可 以 看 到 
同样 的 事情 发 生 。 





图 5-2” 平 铺 小 其 边界 条 件 


下 和 面 是 如 何 为 类 马 群 模拟 实现 平 铺 小 块 边 界 条 


def applyBC(self): 
"""apply boundary conditions""" 
deltaR - 2.0 
for coord in self.pos: 


e if coord[0] > width + deltaR: 
coord[0] - - deltaR 
if coord[0] « - deltaR: 
coord[0] = width + deltaR 


if coord[1] > height + deltaR: 
coord[1] = - deltaR 

if coord[1] « - deltaR: 
coord[1] = height + deltaR 


在 代行 ， 如 果 X 坐 标 比 小 块 的 宽度 大 ， 则 将 它 
设置 回 小 块 的 左 侧 边缘 。 该 行 中 的 deltaR 提 供 了 一 
个 微小 的 缓冲 区 ， 它 允许 类 马 群 个 体 开始 从 相反 方 
回回 来 之 前 ， 稍 稍 移出 小 块 之 外 一 点 ， 从 而 产生 更 
好 的 视觉 效果 。 在 小 块 的 左 侧 、 顶 部 和 的 部 边缘 执 
行 类 似 的 检查 。 


5.33 HRS HE 

要 生成 动画， 需要 知道 类 乌 群 个 体 的 位 置 和 速 
度 ， 并 有 办 法 在 每 个 时 间 步 骤 中 表示 位 置 和 运动 方 
[H] « 





1 绘制 类 乌 群 个 体 的 号 体 和 头 部 


为 了 生成 类 乌 群 动画 ， 我 们 用 matplotlib 和 一 点 
小 技巧 来 绘制 位 置 和 速度 。 将 每 个 类 乌 群 个 体 画 成 
两 个 贺 ， 如 图 5-3 所 示 。 较 大 的 圆 代 表 里 体 ， 较 小 
的 圆 表示 头 部 。 点 P 是 身体 的 中 心 ， 五 是 头 部 的 中 
i. MATH = P +k x V 来 计算 五 的 位 置 ， 其 中 V 
是 类 乌 群 个 体 的 速度 ，k 是 和 常数。 在 任何 给 定时 
间 ， 类 乌 群 个 体 的 头 指 同和 运动 的 方向 。 这 指明 了 类 
乌 群 个 体 的 移动 方 同 ， 比 只 画 里 体 更 好 。 






图 5-3 ”表示 类 乌 群 个 体 


在 下 面 的 代码 户 段 中 ， 利 用 matplotliib， 用 圆 形 
标记 画 出 类 乌 群 个 体 的 里 体 。 


fig = plt.figure() 
ax = plt.axes(xlim-(0, width), ylim=(®, height)) 


pts, = ax.plot([], [], markersize-10, c-'k', marker='o', 1s= 
beak, = ax.plot([], [], markersize-4, c-'r', marker='o', 1s= 


e anim =  animation.FuncAnimation(fig, tick, fargs= 
(pts, beak, boids), 


interval=50) 


EOMNMOIT HARSH MAN ALA Cpts) 
和 头 部 (beak) 标记 设置 大 小 和 形状 。 在 全 行为 动 
画 窗 口 添 加 鼠标 按钮 事件 。 既 然 知 道 了 如 何 绘制 身 
体 和 唆 ， 让 我 们 看 看 如 何 更 新 它们 的 位 置 。 


2. 更 新 类 马 群 个 体 的 位 置 


动 国 开 始 后 ， 需 要 更 新 吴 体 和 头 的 位 置 ， 它 指 
明了 类 马 群 个 体 移 动 的 方 回 。 用 以 下 代码 来 实现 : 








vec = self.pos + 10*self.vel/self.maxVel 


e 
eo beak.set data(vec.reshape(2*self.N) 
[::2], vec.reshape(2*self.N)[1::2]) 


在 @ 行 ， 计 算 头 部 的 位 置 ， 即 在 速度 (vel) 
的 方向 上 增加 10 个 单位 的 位 移 。 该 位 移 确定 了 嗓 和 











身体 之 间 的 距离 。 在 信行 ， 用 头 部 位 置 的 新 值 来 更 
3$ (reshape) matplotlib 的 轴 (set_data)。[::2] 从 速 
度 列表 中 选 出 偶数 元 素 〈(x 轴 的 值 )，[1::2] 选 出 奇 
数 元 素 (Y 轴 的 值 ) 。 


5.3.4 应 用 类 乌 群 规则 


现在 ， 要 在 Python 中 实现 类 乌 群 的 3 个 规则 。 
我 们 用 “umpy 的 方式 ”来 完成 这 件 事 ， 避 免 循环 并 
利用 高 度 优化 的 numpy 方 法 。 


import numpy as np 
from scipy.spatial.distance import squareform, pdist, cdist 


def test2(pos, radius): 
# get distance matrix 


e distMatrix - squareform(pdist(pos)) 
# apply threshold 
(2) D = distMatrix < radius 
# compute velocity 
© vel = pos*D.sum(axis=1).reshape(N, 1) - D.dot(pos) 


return vel 


TE@&FT, Hisquareform()fllpdist7; 7X CfEscipy 
库 中 定义 ) ， 来 计算 一 组 点 之 间 两 两 的 距离 〈 从 数 
组 中 任意 取 两 点 ， 计 算 距 离 ， 然 后 针对 所 有 可 能 的 
两 点 对 这 么 做 )。 例 如 ， 在 下 面 代码 中 ， 有 3 个 
点 ， 这 意味 着 3 种 可 能 两 点 对 : 


>>> import numpy as np 
>>> from scipy.spatial.distance import squareform, pdist 


>>> x = np.array([[0.0, 0.0], [1.0, 1.0], [2.0, 2.0]]) 
>>> squareform(pdist(x) ) 

array([[ 0. , 1.41421356, 2.82842712], 

[ 1.41421356, 0. , 1.41421356], 

[ 2.82842712, 1.41421356, ©. ]]) 


squareform() 方 法 给 出 一 个 3x3 和 矩阵 ， 其 中 项 Mi 
给 出 了 反 Pi 和 Pj 之 间 的 距离 。 接 下 来 ， 在 信行 ， 基 
ERES wea 使 用 同样 的 3 点 的 例子 ， 得 
到 如 下 结 





>>> squareform(pdist(x)) < 1.4 
array([[ True, False, False], 
[False, True, False], 

[False, False, True]], dtype=bool) 





“< 比较 针对 距离 小 于 给 定 国 值 《这 个 例子 中 
是 1.4) 的 所 有 距离 对 ， 设置 年 阵 的 项 。 这 种 紧凑 的 
方式 表达 了 你 想 要 的 结 来 ， 更 接近 实际 的 思考 方 

Ae 


在 全 行 的 方法 有 点 复杂 。D.sum0 方 法 按 列 对 
知 阵 中 的 True 值 求 和 和 。reshape 是 必需 的 ， 因为 和 大 
N 个 值 的 一 维 数组 〈 形 如 (N，)) ， 而 你 希望 它 形 如 
(N, 1) ， 这 样 它 就 能 够 SACHA. D.dot() 
te FEE RIN eA GER) 。 


test2 比 test1 的 小 得 多 ， 但 它 真 正 的 优势 是 速 





度 。 让 我 们 用 Python timeit 模 块 来 比较 前 面 两 种 方 
法 的 性 能 。 下 面 的 代码 写 在 Python 解释 需 中 ， 假 设 
函数 testL 和 test2 的 代码 在 同一 目录 下 的 test.py 文 件 
中 : 





>>> from timeit import timeit 

>>> timeit('testi(pos, 100)', 'from test import testi, N, pos 
number=100) 

7.880876064300537 

>>> timeit('test2(pos, 100)', 'from test import test2, N, pos 
number=100) 

0.036969900131225586 


在 我 的 计算 机 上 ， 没 有 循环 的 numpy 人 代码 比 使 
用 显 式 循 环 的 代码 快 约 200 倍 ! (MA? 它们 
不 是 天 不 多 都 是 一 回 事 吗 ? 


原因 在 于 ， 作 为 一 种 解释 型 语言 ，Python 天 生 
驶 比 C 语 言 这 样 的 编译 语言 慢 。numpy 库 提供 了 高 
度 优 化 的 数组 操作 方法 ， 带 来 了 了 Python 的 方便 和 几 
平 C 语 言 相 等 的 性 能 (你 会 发 现 ， 如 果 重 新 组 织 算 
法 ， 每 次 操作 整个 数组 ， 不 要 循环 单个 元 素来 进行 
计算 ， 这 样 numpy 的 效果 最 好 ) 。 


下 面 的 方法 利用 前 面 讨论 的 numpy 技 术 ， 应 用 
类 乌 群 的 3 个 规则 : 























def applyRules(self): 
# apply rule £1: Separation 
D - distMatrix « 25.0 


vel = self.pos*D.sum(axis-1).reshape(self.N, 1) - D.dot(self. 
(2) self.limit(vel, self.maxRuleVel) 


# distance threshold for alignment (different from separation 
D = distMatrix < 50.0 
# apply rule #2: Alignment 
© vel2 = D.dot(self.vel) 
self.limit(vel2, self.maxRuleVel) 
vel += vel2; 
# apply rule #3: Cohesion 
o vel3 - D.dot(self.pos) - self.pos 
self.limit(vel3, self.maxRuleVel) 
vel += vel3 


return vel 
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离 ? 相 邻 个 体 一 定 距离 ， 正 如 本 节 开 始 时 的 讨论 。 
在 信行 ， 计 算出 的 速度 被 限制 在 某 个 最 大 值 以 内 
(没有 这 项 检查 ， 值 将 随 着 每 个 时 间 步 骤 增 加 ， 模 
拟 将 失控 ) o 


在 个 行 应 用 列队 规则 时 ，50 个 单位 的 半径 内 ， 
所 有 相 邻 个 体 的 速度 之 和 限制 为 一 个 最 大 值 。 这 样 
做 是 为 了 计算 的 最 后 速度 不 会 无 限 增加 。 因 此 ， 任 
何 给 定 的 个 体 ， 郑 会 受到 指定 半径 内 个 体 的 平均 速 
度 影 响 ， 并 据 此 列队 《利用 紧凑 的 numpy 语 法 做 这 
种 计算 ， 让 事情 变 得 简单 、 快 捷 。 


最 后 ， 在 信行 应 用 内 到 规则 ， 为 每 个 个 体 增加 











一 个 速度 矢量 ， 它 指 同一 定 半径 内 相 邻 个 体 的 重心 
或 几何 中 心 。 利 用 布尔 距离 矩阵 和 numpy 的 方法 ， 
实现 紧凑 的 语法 。 


5.3.5 ”添加 个 体 


类 乌 群 模拟 的 核心 规则 会 导致 类 乌 群 展示 出 群 
聚 行为 。 但 是 ， 让 我 们 在 模拟 过 程 中 添加 一 个 个 
体 ， 看 看 表现 如 何 ， 让 事情 变 得 更 有 趣 。 


下 面 的 代码 创建 一 个 鼠标 事件 ， 让 你 点 击 鼠 标 
磊 键 添加 一 个 个 体 。 个 体 将 出 现在 区 标的 位 置 ， 其 
有 随机 指定 的 速度 。 


# add a "button press" event handler 


cid - fig.canvas.mpl connect('button press event', buttonPres 


在 代行 ， 用 mpl_connect0) 方 法 同 matplotlib 画 布 
添加 一 个 按钮 按 下 事件 。 每 次 在 模拟 窗口 按 下 鼠标 
时 ，buttonPress() 方 法 都 会 被 调 用 。 


现在 ， 为 了 处 理 鼠 标 事件 ， 实 际 创 建英 马 群 个 
WR. WILA PANIS: 


def buttonPress(self, event): 
"""event handler for matplotlib button presses""" 
# left-click to add a boid 

@ if event.button is 1: 


e self.pos - np.concatenate((self.pos, 


np.array([[event.xdata, event.ydata]])), 


axis-0) 
# generate a random velocity 
e angles - 2*math.pi*np.random.rand(1) 


v - np.array(list(zip(np.sin(angles), np.cos(angles)))) 
self.vel - np.concatenate((self.vel, v), axis-0) 
self.N += 1 








FONT. MRM ICE RGB. (EOTT, 
Tf(event.xdata, event.ydata)Z5 HR] BR bas fic ELS JH 381] 
JS BERI EA. FECT ABE BS TIR. EN 
随机 速度 天 量 添 加 到 类 乌 群 的 速度 数组 ， 并 将 交 乌 
群 的 计数 增加 1。 


5.3.6 okays SH 


3 个 模拟 规则 保持 类 乌 群 在 移动 时 成 为 一 个 群 
体 。 但 是 ， 和 群体 受到 惊扰 时 ， 会 发 生 什 么 ? DI 
拟 这 种 情况 ， 可 以 引入 一 种 “驱散 ”效果 : 如 果 在 用 
PRA (UD 窗口 中 单 击 右 键 ， 群 体 束 会 分 散 。 你 
可 以 认为 这 是 群体 面 对 突 然 出 现 的 捕食 者 的 反应 ， 
或 突然 出 现 一 声 巨 啊 惊吓 了 乌 群 。 下 面 是 实现 该 效 
果 的 一 种 方式 ， 它 作为 buttonPress() 方 法 的 延续 : 











# right-click to scatter boids 
e elif event.button is 3: 
# add scattering velocity 
self.vel 十 二 0.1* 
(self.pos - np.array([[event.xdata, event.ydata]])) 


在 代行 ， 检 查 鼠 标 按键 是 人 否 是 右键 单 击 事件 。 
在 信行 ， 改 变 每 个 个 体 的 速度 ， 在 干扰 出 现 的 点 
( 即 点 击 女 标的 位 置 ) 的 相反 的 方 回 上 增加 一 个 分 
量 。 最 初 ， 类 乌 群 将 飞 离 该 点 ， 但 你 会 看 到 ，3 个 
规则 胜出 ， 类 马 群 将 作为 群体 再 次 会 聚 。 


5.3.7. 命令 行 参 数 
下 面 是 类 乌 群 程序 如 何 处 理 命令 行 参数 : 





parser = argparse.ArgumentParser(description-"Implementing Cr 
Reynolds's Boids...") 
# add arguments 
parser.add argument('--num- 
boids', dest='N', required=False) 
args = parser.parse_args() 


# set the initial number of boids 
N = 100 
if args.N: 

N = int(args.N) 


# create boids 
boids = Boids(N) 





main() 方 法 首先 在 @ 行 设置 了 一 个 命令 行 选 
项 ， 使 用 我 们 熟悉 的 argparse 模 块 。 


5.3.8 ”Boids 类 
接 下 来 看 看 Boids 类 ， 它 代表 了 模拟 。 


class Boids: 
""class that represents Boids simulation""" 
def _ init (self, N): 
""initialize the Boid simulation""" 

o # initial position and velocities 
self.pos = [width/2.0, height/2.0] + 10*np.random.rand(2*N).r 

# normalized random velocities 

angles - 2*math.pi*np.random.rand(N) 


self.vel - np.array(list(zip(np.sin(angles), np.cos(angles))) 
self.N =N 
# minimum distance of approach 
self.minDist - 25.0 

# maximum magnitude of velocities calculated by "rules" 
self.maxRuleVel - 0.03 


# maximum magnitude of the final velocity 
self.maxVel - 2.0 


Boid 类 处 理 初 始 化 ， 更 新 动画 ， 并 应 用 规则 。 
在 @ 行 和 随后 的 行 中 ， 初 始 化 位 置 和 速度 数组 。 


boids.tick() 在 每 个 时 间 步 又 被 调 用 ， 以 便 更 新 
zii, "Ul Br: 





def tick(frameNum, pts, beak, boids): 
#print frameNum 
""update function for animation""" 
boids.tick(frameNum, pts, beak) 
return pts, beak 
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则 ， 速 度 将 在 每 个 时 间 步 又 无 限制 地 增加 ， 模 拟 将 
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def limitVec(self, vec, maxVal): 
"""limit the magnitude of the 2D vector""" 
mag - norm(vec) 
if mag » maxVal: 


vec[0], vec[1] = vec[0]*maxVal/mag, vec[1]*maxVal/mag 
e def limit(self, X, maxVal): 
"""limit the magnitude of 2D vectors in array X to 


for vec in X: 
self.limitVec(vec, maxVal) 


在 代行 定义 了 limitO 方 法 ， 限 制 了 数组 中 的 
值 ， 采 用 模拟 规则 计算 出 的 值 。 


5.4 完整 代码 


下 面 是 类 马 群 模拟 的 完整 程序 。 也 可 以 从 


https://github.com/electronut/pp/blob/ 
master/boids/boids.py 下 载 该 项 目的 代码 。 


import sys, argparse 

import math 

import numpy as np 

import matplotlib.pyplot as plt 

import matplotlib.animation as animation 

from scipy.spatial.distance import squareform, pdist, cdist 
from numpy.linalg import norm 


width, height - 640, 480 


class Boids: 
"""class that represents Boids simulation""" 
def _ init (self, N): 
"""initialize the Boid simulation""" 
# initial position and velocities 


self.pos = [width/2.0, height/2.0] + 10*np.random.rand(2*N).r 
# normalized random velocities 
angles - 2*math.pi*np.random.rand(N) 


self.vel - np.array(list(zip(np.sin(angles), np.cos(angles))) 
self.N =N 
# minimum distance of approach 
self.minDist - 25.0 


# maximum magnitude of velocities calculated by "rules" 
self.maxRuleVel - 0.03 
# maximum maginitude of the final velocity 
self.maxVel - 2.0 


def tick(self, frameNum, pts, beak): 
"""Update the simulation by one time step.""" 


# get pairwise distances 


self.distMatrix - squareform(pdist(self.pos)) 

# apply rules: 

self.vel += self.applyRules() 

self.limit(self.vel, self.maxVel) 

self.pos += self.vel 

self.applyBC() 

# update data 

pts.set data(self.pos.reshape(2*self.N)[::2], 
self.pos.reshape(2*self.N)[1::2]) 

vec = self.pos + 10*self.vel/self.maxVel 

beak.set data(vec.reshape(2*self.N)[::2], 
vec.reshape(2*self.N)[1::2]) 


def limitVec(self, vec, maxVal): 


"""limit the magnitide of the 2D vector""" 
mag = norm(vec) 
if mag » maxVal: 


vec[0], vec[1] = vec[0]*maxVal/mag, vec[1]*maxVal/mag 


def limit(self, X, maxVal): 


"""limit the magnitide of 2D vectors in array X to max» 
for vec in X: 


self.limitVec(vec, maxVal) 


def applyBC(self): 
"""apply boundary conditions""" 
deltaR - 2.0 


for coord in self.pos: 
if coord[0] > width + deltaR: 


coord[0] = - deltaR 

if coord[0] « - deltaR: 
coord[0] = width + deltaR 

if coord[1] > height + deltaR: 
coord[1] = - deltaR 

if coord[1] « - deltaR: 
coord[1] = height + deltaR 


def applyRules(self): 


# apply rule #1: Separation 
D = self.distMatrix < 25.0 


vel = self.pos*D.sum(axis=1).reshape(self.N, 1) - D.dot(self. 
self.limit(vel, self.maxRuleVel) 


# distance threshold for alignment (different from separation 


D = self.distMatrix < 50.0 


# apply rule #2: Alignment 

vel2 = D.dot(self.vel) 
self.limit(vel2, self.maxRuleVel) 
vel += vel2; 


# apply rule #3: Cohesion 

vel3 = D.dot(self.pos) - self.pos 
self.limit(vel3, self.maxRuleVel) 
vel += vel3 


return vel 


def buttonPress(self, event): 
"""event handler for matplotlib button presses""" 
# left-click to add a boid 
if event.button is 1: 
self.pos - np.concatenate((self.pos, 


np.array([[event.xdata, event.ydata]])), 
axis-0) 
# generate a random velocity 
angles - 2*math.pi*np.random.rand(1) 


v - np.array(list(zip(np.sin(angles), np.cos(angles)))) 
self.vel - np.concatenate((self.vel, v), axis-0) 
self.N += 1 
# right-click to scatter boids 
elif event.button is 3: 
# add scattering velocity 
self.vel += 0.1* 
(self.pos - np.array([[event.xdata, event.ydata]])) 


def tick(frameNum, pts, beak, boids): 
#print frameNum 
"""update function for animation""" 
boids.tick(frameNum, pts, beak) 
return pts, beak 


# main() function 

def main(): 
# use sys.argv if needed 
print('starting boids...') 


parser = argparse.ArgumentParser(description="Implementing Cr 
Reynold's Boids...") 
# add arguments 


parser.add argument( '--num- 
boids', dest-'N', required-False) 
args - parser.parse args() 


# set the initial number of boids 
N = 100 
if args.N: 

N - int(args.N) 


# create boids 
boids - Boids(N) 


# set up plot 
fig - plt.figure() 
ax = plt.axes(xlim-(0, width), ylim=(®, height)) 
pts, = ax.plot([], [], markersize-10, c='k', marker='o', 1s=' 
beak, = ax.plot([], [], markersize-4, c-'r', marker='o', 1s=' 
anim - animation.FuncAnimation(fig, tick, fargs- 
(pts, beak, boids), 
interval-50) 
# add a "button press" event handler 
cid - fig.canvas.mpl connect('button press event', boids.butt 
plt.show() 
# call main 


if | name  -- 
main() 


|. main ': 


55 运行 类 乌 群 模拟 





有 运行 模拟 时 会 发 生 什么 。 输 入 
以 下 内 容 


$ python3 boids.py 








类 乌 群 模拟 开始 ， 所 有 个 体 应 该 聚集 在 窗口 的 
让 模拟 运行 一 段 时 间 ， 类 乌 群 应 该 开 群 
， 构 成 的 模式 类 似 于 图 5-4 所 示 。 





0 100 200 300 400 500 600 
图 5-4 ”类 乌 群 的 运行 示例 
点 击 模拟 窗口 。 新 的 个 体 应 该 出 现在 该 位 置 ， 








当 它 过 到 乌 群 时 ， 速 度 应 改变 。 现 在 ， 单 击 鼠 标 右 
键 。 马 群 应 首先 分 散 ， 但 随后 重新 聚集 。 


5.6 ”小结 


这 个 项 目 利用 Craig Reynolds 提 出 的 3 个 规则 ， 
模拟 乌 群 〈 或 类 乌 群 ) 的 聚集 。 我 们 学 习 了 如 何 使 
用 numpy 数 组 ， 如 何 使 用 显 式 循环 ， 以 及 用 整个 数 
组 上 的 numpy 方 法 来 提高 计算 速度 。 我 们 利用 
scipy.spatial 模 块 来 执行 快速 和 方便 的 距离 计算 ， 实 
现 了 一 个 matplotlib 技 巧 ， 利 用 两 个 记号 来 表示 个 体 
AMAMI. wa, TIN SUE, AEE F 
标 按钮 来 改变 matplotlib 的 绘图 。 











5.7 ER 


下 面 有 一 些 方式 ， 可 以 进一步 探索 群 聚 行为 。 

1. 为 类 乌 群 实现 避 障 ， 编 写 一 个 新 方法 
avoidObstacle0， 并 在 应 用 3 个 规则 之 后 应 用 它 ， 像 
下 面 这 样 : 


self.vel += self.applyRules() 
self.vel += self.avoidObstacle() 





avoidObstacle() 方 法 应 该 使 用 预先 定义 的 元 组 
碍 物 的 位 置 (x，y)， 但 只 在 个 体 处 于 障碍 物 的 半 符 
R 之 内 时 。 可 以 将 其 视 为 是 个 体 看 见 障碍 物 ， 并 避 
开 它 的 距离 。 可 以 用 命令 行 选项 指定 (x4， y, Br 
ZH 


2. 如 果 类 马 群 飞 过 一 阵 强 风 ， 会 友 生 什么 情 
况 ? 以 随机 选择 的 时 间 步 又 ， 对 所 有 个 体 增 加 一 个 
全 局 的 速度 分 量 ， 来 便 拟 这 种 情况 。 关 乌 群 应 该 暂 
时 受到 风 的 影响 ， 但 风 停 止 后 义 回 到 和 群 聚 状态 。 








第 三 部 分 AA AR 


“你 可 以 通过 视觉 观察 到 很 多 东西 。” 
Yogi Berra 








第 6 音 ASCII 文 本 图 形 





在 20 世 纪 90 年 代 ， 电 子 邮 件 占据 着 统治 地 位 ， 
图 形 处 理 能 力 很 有 限 ， 篆 见 的 做 法 是 在 电子 邮件 中 
包含 一 个 签名 ， 它 是 由 文本 制作 的 图 形 ， 一 般 称 为 
ASCII 文 本 图 形 (ASCII 是 一 个 简单 的 字符 编码 方 
案 ) 。 几 6-1 展 示 了 两 个 例子 。 尽 管 因特网 已 经 让 
共享 图 像 容 易 很 多 ， 但 出 身 和 卑微 的 文本 图 形 还 没有 
HR: 

ASCII 文 本 图 形 的 源头 是 19 世 纪 后 期 出 现 的 打 
字 机 文本 图 形 。 在 20 世 纪 60 年 代 ， 计 算 机 有 了 较 弱 
的 图 形 处 理 硬件 ，ASCII 被 用 于 表示 图 形 。 今 天 ， 
ASCII 文 本 图 形 继续 作为 因特网 上 的 一 种 表现 形 




















式 ， 你 可 以 在 网 上 找到 各 种 创意 的 例子 。 


这 个 项 目 用 Python 创 建 一 个 程序 ， 从 图 像 生 成 
ASCII 文 本 图 形 。 该 程序 让 你 指定 输出 (文本 列 
数 ) 的 宽度 ， 并 设置 垂直 比例 因子 。 它 也 支持 两 种 
灰 度 值 到 ASCI 字 人 符 的 映射 : 稀 焉 的 10 级 映射 和 更 
精细 校正 的 70 级 映射 。 


要 从 图 像 生成 ASCII 文 本 图 形 ， 需 要 学 习 如 何 
做 到 以 下 几 点 : 





。 用 Pillow 将 彩色 图 像 转换 成 灰 度 图 像 ， 它 是 
Python 的 图 像 库 (PIL) 的 一 个 分 文 ; 

。 使 用 numpy 计 算 灰 度 图 像 的 平均 亮度 ; 

。 用 一 个 字符 串 作 为 灰 度 值 的 快速 租 找 表 。 
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图 6-1 ASCII 文 本 图 形 的 例子 


6.1 工作 原理 


该 项 目 利 用 了 这 样 一 个 事实 : 从 远 处 看 ， 我 们 
HARE RBA hoe ENCE PEE. Bla, A 
6-24, HUER- PERDRE, EES 
W, EHRT ZERRAK FIERE KR: 
pee erem FAS 
以 。 


ASCII 文 本 图 形 的 生成 方法 是 ， 将 图 像 分 割 成 
小 块 ， 并 用 ASCII 字 符 符 换 一 小 块 的 平均 RGB 值 。 
从 远 处 看 ， 因 为 眼睛 的 分 辨 率 有 限 ， 我 们 大 致 会 丢 
失 细 节 ， 看 到 ASCII 文 本 图 形 中 的 “平均 ” 值 ， 否 则 
MA AIG ERAS BB A SE. 





图 6-2” 灰 度 图 像 的 平均 值 


该 程序 将 给 定 的 图 像 先 转换 为 8 位 的 灰 度 ， 让 
每 个 像素 有 一 个 灰 度 值 ， 范 围 在 [0,255] (8 位 整数 
的 范围 ) 。 将 这 个 8 位 值 看 成 是 膨 有 度 ，0 表 示 黑 色 ， 
255 表 示 日 色 ， 中 间 值 是 不 同 程度 的 灰色 。 


接 独 ， 将 该 图 像 分 割 成 MxN 个 小 块 构成 的 网 
格 ( 其 中 ，M 和 N 是 ASCII 文 本 图 形 中 的 行 和 列 编 
F) 。 然 后 程序 计算 网 格 中 每 个 小 块 的 平均 腕 撤 
值 ， 通 过 预定 义 的 一 些 有 梯度 的 ASCII 了 字符 (一 组 
不 断 增加 的 值 ) 来 表示 [0,255] 范 围 的 灰 度 值 ， 与 适 
当 的 ASCII 字 符 匹 配 。 它 将 用 这 些 值 作为 沈 度 值 的 
ARK. 


完成 的 ASCII 文 本 网 形 只 是 一 些 文 本 行 。 要 显 
示 文 本 ， 就 要 用 到 Courier 这 样 的 等 宽 字 体 ， 因 为 如 
果 每 个 文本 字符 宽度 不 相同 ， 图 像 中 字符 将 无 法 正 
确 地 按 网 格 排 列 ， 会 得 到 间隔 不 均 和 失真 的 输出 。 


所 用 字体 的 “ 横 纵 比 ”"( 宽 度 与 高 度 之 比 〉 也 会 
影 啊 最 终 图 像 。 如 果 一 个 字符 所 占 空间 的 横 纵 比 与 
该 字符 取代 的 图 像 小 块 的 横 纵 比 不 同 ， 则 最 终 的 
ASCII 字 符 图 形 会 出 现 失 真 。 实 际 上 ， 你 试图 用 一 
个 ASCII 字 符 来 蔡 换 图 像 小 块 ， 所 以 它们 的 形状 要 
匹配 。 例 如 ， 如 果 将 图 像 分 割 成 正方 形 小 块 ， 然 后 
用 一 种 高 度 拉 伸 的 字体 蔡 换 每 个 小 块 ， 最 终 的 结果 



































将 出 现 王 直 拉 伸 。 

为 了 解决 这 个 问题 ， 需 要 缩放 网 格 中 的 行 数 ， 
以 匹配 Courier 的 长 宽 比 。 (可 以 向 程序 发 送 命 令 行 
人 参数， 修改 缩 放 ， 以 匹配 其 他 字体 。) 


总 之 ， 下 面 是 程序 生成 ASCII 文 本 图 形 的 步 





1. 将 输入 图 像 转 成 灰 度 ; 
2. 将 图 像 分 成 MxN 个 小 块 ; 


3. 修正 M 行 数 ) ， 以 匹配 图 像 和 字体 的 横 
纵 比 ; 


4. 计算 每 个 小 块 图 像 的 平均 亮度 ， 然 后 为 每 
个 小 块 查找 合适 的 ASCII 字 符 ; 

5. 汇集 各 行 ASCII 字 符 串 ， 将 它们 打印 到 文 
件 ， 形 成 最 终 图 像 。 





6.2 ”所 需 模 块 


这 个 项 目 将 使 用 Pillow Python 图 像 库 的 友好 
TX) 来 读 取 图 像 ， 访 问 它们 的 底层 数据 ， 创 建 并 
修改 它们 。 还 将 使 用 numpy 库 来 计算 平均 值 。 
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FR aC rE SORES, HIT ERRASCICA Kd 
形 。 然 后 ， 考 虑 如 何 将 图 像 分 割 成 小 块 ， 以 及 如 何 
计算 这 些小 块 的 平均 亮度 。 接 下 来 ， 用 ASCII 字 符 
蔡 换 小 块 ， 生 成 最 终 的 输出 。 最 后 ， 为 程序 设置 命 
SAT HEMT» 允许 用 户 指定 输出 尺寸 、 输 出 文件 名 ， 


整个 项 目的 代码 ， 请 参阅 6.4 节 。 


6.3.1 定义 灰 度 等 级 和 网 格 


创建 程序 的 第 一 步 是 ， 先 定义 两 种 灰 度 等 级 作 
KEE, FOR SS BAPE RA ASCII FF 





# 70 levels of gra 
€) gscalel = "SB M ud 
(dsl)? fes XIII; i, V^ 

# 10 levels of gray 
© gscale2 = "@%#*+=-:. " 


@ 行 的 值 gscalel 是 70 级 的 灰 度 梯度 ， 人 人行 的 
gscale2 是 简单 的 10 级 灰 度 梯度 。 这 两 个 值 保 存 为 字 
符 串 ， 包 含 一 组 字符 串 ， 从 最 黑暗 变 到 最 亮 〈 要 了 
解 如 何 用 字符 表示 灰 度 值 的 更 多 内 容 ， 参 见 Paul 











Bourke 的 《Character Representation of Grey Scale 
Images》， 网 址 在 
http://paulbourke.net/dataformats/asciiart/) . 


BLAN TARERE, BAT UME AR. IB] 
代码 打开 图 像 ， 并 分 割 成 网 格 : 


# open the image and convert to grayscale 
@ image = Image.open(fileName).convert("L") 
# store the image dimensions 
© w, H = image.size[0], image.size[1] 
# compute the tile width 
® w = w/cols 
# Compute the tile height based on the aspect ratio and Scale 
© h= w/scale 
# compute the number of rows to use in the final grid 
Q rows - int(H/h) 


在 @ 行 ，Image.open() 打 开 输 入 图 像 文件 ， 
Image.convert() 将 该 图 像 转换 为 灰 度 图 像 。“L” 代 表 
luminance， 是 图 像 亮 度 的 单位 。 


在 信行 ， 保 存 输入 图 像 的 额度 和 高 上 度 。 在 全 
行 ， 根 据 用 户 指定 的 列 数 (cols) ， 计 算 小 块 的 宽 
度 〈 如 果 用 户 没 有 在 命令 行 中 设置 其 他 值 ， 程 序 默 
认 使 用 80 列 ) 。 对 于 人 @@ 行 的 除法 ， 使 用 浮 点 而 不 是 
整数 除法 ， 避 人 免 在 计算 小 块 尺寸 时 的 截断 误差 。 


知道 小 块 的 宽度 后 ， 在 @ 行 利用 垂直 比例 系数 
《作为 scale 传 入 ) ， 计 算 它 的 高 度 。 在 @ 行 ， 用 这 


























个 网 格 高 度 来 计算 行 数 。 


比例 系数 确定 每 个 小 块 的 大 小 ， 以 匹配 用 于 显 
示 文 本 的 字体 的 横 纵 比 ， 这 样 最 终 图 像 不 会 失真 。 
scale 的 值 可 以 作为 参数 传 入 ， 或 者 设置 为 默认 值 
0.43， 在 用 Courier 显 示 结 果 时 ， 效 果 很 好 。 


63.2 ”计算 平均 亮度 


接 下 来 ， 计 算 灰 度 图 像 中 每 一 小 块 的 平均 腕 
上 度 。 子 数 getAverageL( 完 成 这 项 工作 。 





@ def getAveragel (image): 

# get the image as a numpy array 
im - np.array(image) 

# get the dimensions 

w,h - im.shape 

# get the average 
© return np.average(im.reshape(w*h)) 


在 @ 行 ， 图 像 小 块 作为 PIL ”Image 对 象 传 入 。 
在 信行 ， 将 image 转 换 成 一 个 numpy 数 组 ， 此 时 im 成 
为 一 个 二 维 数组 ， 包 含 每 个 像素 的 亮度 。 在 个 行 ， 
保存 该 图 像 的 尺寸 (宽度 和 高 度 ) 。 在 人 @ 行 ， 
numpy.average() 计 算 该 图 像 中 的 腕 度 平均 值 ， 做 法 
是 用 numpy.reshape0O 先 将 维度 为 宽 和 高 (w，hb) 的 二 
维 数组 转换 成 悄 平 的 一 维 ， 其 长 度 是 宽度 乘 以 高 度 
(w*h)。 然 后 numpy.average() 调 用 对 这 些 数 组 值 求 和 
并 计算 平均 值 。 














6.3.3 ”从 图 像 生 成 ASCII 内 容 
程序 的 主要 部 分 负 贡 从 图 像 生 成 ASCII 内 容 。 


# an ASCII image is a list of character strings 
@ aimg = [] 
# generate the list of tile dimensions 
for j in range(rows): 
[2] y1 = int(j*h) 
y2 = int((j*1)*h) 
# correct the last tile 
if j == rows-1: 
y2 = H 
# append an empty string 
e aimg.append("") 
for i in range(cols): 
# crop the image to fit the tile 
o x1 - int(i*w) 
x2 - int((i*1)*w) 
# correct the last tile 
® if i == cols-1: 
x2 = W 


# crop the image to extract the tile into another Image objec 
img = image.crop((x1, y1, x2, y2)) 
# get the average luminance 

(7) avg = int(getAverageL(img)) 


# look up the ASCII character for grayscale value (avg) 
if moreLevels: 


e gsval = gscalei[int((avg*69)/255)] 
else: 
© gsval = gscale2[int((avg*9)/255)] 
# append the ASCII character to the string 
D aimg[j] += gsval 


在 程序 的 这 一 部 分 ，ASCII 图 像 先 作为 一 个 字 
符 串 列表 保存 ， 该 列表 在 全 行 初 始 化 。 接 下 来 ， 按 
计算 好 的 图 像 小 块 行 数 迭 代 人 遍历 ， 在 信行 和 随后 一 


行 中 ， 计 算 每 个 图 像 小 块 的 起 始 和 结束 坐标 。 虽 
PRISE eT MISE, BERR RMB ZAM 
将 它们 截断 为 整数 。 


接着 ， 因 为 只 有 当 图 像 的 宽度 是 列 数 的 整数 僧 
时 ， 图 像 分 割 成 小 块 时 ， 边 缘 的 小 块 才 有 相同 的 大 
小 ， 所 以 在 最 后 一 行 校正 小 块 的 y 坐 标 ， 将 y 坐 标 设 
置 为 图 像 的 实际 高 度 。 这 样 做 确保 了 图 像 项 部 的 边 
2A PAST o 


在 个 行 ， 为 ASCII 图 像 添 加 一 个 空 字符 串 ， 作 
为 一 种 紧凑 的 方式 来 表示 图 像 的 当前 行 。 接 下 来 会 
填充 这 个 字符 串 (将 字符 串 作为 字符 的 列表 ) 。 


在 全 行 和 下 一 行 ， 计 算 每 个 小 块 的 左 、 右 x 坐 
标 ， 在 人 @ 行 ， 为 最 后 一 小 块 校正 x 坐标 ， 原 因 和 校 
下 y 坐 标 时 一 样 。 在 @@ 行 ， 用 image.crop0 提 取 图 像 
小 块 ， 然 后 将 该 小 块 传 入 getAverageLO 函 数 @， 访 
函数 在 6.3.2 节 中 定义 ， 取 得 小 块 的 平均 亮度 。 在 和 @ 
行 ， 将 平均 亮度 值 从 [0，255] 缩 小 至 [0，9] (默认 
10 级 灰 度 梯度 值 的 范围 ) 。 然 后 ， 用 gscale2〈 保 存 
HB REAR TE BR) TEA PEFR SE, FR BIT DAY ASCII 
值 。 傅 行 类 似 ， 不 同 之 处 在 于 ， 只 有 命令 行 标志 设 
置 为 使 用 70 级 梯度 时 ， 才 会 用 它 。 最 后 ， 在 四 行 ， 
在 文本 行 中 添加 找到 的 ASCII 值 gsval， 代 码 循环 ， 
直到 处 理 完 所 有 行 。 






































6.3.4 ”命令 行 选 项 


接 下 来 ， 为 程序 定义 一 些 命令 行 选 项 。 这 段 代 
t4 fi FH A EJ argparse2s: 


parser = argparse.ArgumentParser(description="descStr") 
# add expected arguments 
parser.add argument('-- 
file', dest-'imgFile', required-True) 
parser.add argument('-- 
scale', dest-'scale', required-False) 
parser.add argument('-- 
out', dest-'outFile', required-False) 
parser.add argument('-- 
cols', dest-'cols', required-False) 
parser.add argument('-- 
morelevels', dest-'moreLevels', action='store_true' ) 








EOI, 包含 指定 图 像 文 件 输入 的 选项 (唯一 
必须 的 参数 ) ， 人 @ 行 设置 下 直 比 例 因 子 ， 全 行 设置 
输出 文件 名 ，@ 行 设置 ASCII 输 出 中 的 文本 列 数 。 
在 人 @ 行 ， 添 加 --morelevels 选 项 ， 让 用 户 选 择 更 多 层 
UR EY AR BER o 


6.3.5 ”将 ASCII 文 本 图 形 字 符 串 写 入 文本 
文件 

最 后 ， 将 生成 的 ASCII 字 符 串 列表 ， 写 入 一 个 
文本 文件 : 





# open a new text file 


@ f = open(outFile, 'w') 
# write each string in the list to the new file 
for row in aimg: 
f.write(row + '\n') 
# clean up 
® f.close() 


在 @ 行 ， 使 用 内 置 的 open0 方 法 ， 打 开 一 个 新 
的 文本 文件 用 于 写 入 。 然 后 在 信行 ， 达 代 遍 i AER 
中 的 每 个 字符 串 ， 将 它 写 入 文件 ， 在 @ 行 ， 关 闭 文 
件 对 象 ， 释 放 系 统 资 源 。 


64 完整 代码 


下 面 是 完整 的 ASCIT 文 本 图 形 程序 。 也 可 以 从 
https://github.com/electronut/pp/ 
blob/master/ascii/ascii.py 下 载 该 项 目的 代码 。 


import sys, random, argparse 
import numpy as np 

import math 

from PIL import Image 


# grayscale level values from: 
# http://paulbourke.net/dataformats/asciiart/ 


# 70 levels of gray 
gscale1 = "$@B%8&WM#* oahkbdpqwmZOOQLCJUYXzcvunxrjft/\ | ()1{} 
[]?-_+~<>i!1I;:,\"4 


# 10 levels of gray 
gscale2 = '@%#*+=-:. ' 


def getAverageL(image): 


Given PIL Image, return average value of grayscale value 
# get image as numpy array 

im = np.array(image) 

# get the dimensions 

w,h = im.shape 

# get the average 

return np.average(im.reshape(w*h) ) 


def covertImageToAscii(fileName, cols, scale, moreLevels): 


Given Image and dimensions (rows, cols), returns an m*n list 


# declare globals 


global gscalei, gscale2 

# open image and convert to grayscale 
image - Image.open(fileName).convert('L') 

# store the image dimensions 

W, H = image.size[0], image.size[1] 
print("input image dims: %d x %d" % (W, H)) 
# compute tile width 

w= W/cols 


# compute tile height based on the aspect ratio and scale of 
h = w/scale 
# compute number of rows to use in the final grid 
rows = int(H/h) 


print("cols: %d, rows: %d" % (cols, rows)) 
print("tile dims: %d x %d" % (w, h)) 


# check if image size is too small 

if cols > W or rows > H: 
print("Image too small for specified cols!") 
exit(0) 


# an ASCII image is a list of character strings 
aimg - [] 
# generate the list of tile dimensions 
for j in range(rows): 
y1 - int(j*h) 
y2 = int((j*1)*h) 
# correct the last tile 
if j -- rows-1: 
y2 = H 
# append an empty string 
aimg.append("") 
for i in range(cols): 
# crop the image to fit the tile 
x1 = int(i*w) 
x2 = int((i+1)*w) 
# correct the last tile 
if i -- cols-1: 
x2 =W 


# crop the image to extract the tile into another Image objec 
img = image.crop((x1, y1, x2, y2)) 
# get the average luminance 
avg = int(getAverageL(img)) 


# look up the ASCII character for grayscale value (avg) 
if moreLevels: 


gsval = gscalei[int((avg*69)/255) | 
else: 

gsval - gscale2[int((avg*9)/255)] 
# append the ASCII character to the string 
aimg[j] += gsval 


# return text image 
return aimg 


# main() function 
def main(): 
# create parser 


descStr - "This program converts an image into ASCII art." 
parser = argparse.ArgumentParser(description=descStr) 
# add expected arguments 
parser.add argument('-- 
file', dest-'imgFile', required-True) 
parser.add argument('-- 
scale', dest-'scale', required-False) 
parser.add argument('-- 
out', dest-'outFile', required-False) 
parser.add argument('-- 
cols', dest-'cols', required-False) 
parser.add argument('-- 
morelevels', dest='moreLevels', action='store_true' ) 


# parse arguments 
args = parser.parse_args() 


imgFile = args.imgFile 
# set output file 
outFile = 'out.txt' 
if args.outFile: 
outFile = args.outFile 
# set scale default as 0.43, which suits a Courier font 
scale = 0.43 
if args.scale: 
scale = float(args.scale) 
# set cols 
cols = 80 
if args.cols: 
cols = int(args.cols) 
print('generating ASCII art...') 
# convert image to ASCII text 


aimg = covertlImageToAscii(imgFile, cols, scale, args.moreLeve 


# open a new text file 
f = open(outFile, 'w') 
# write each string in the list to the new file 
for row in aimg: 
f.write(row + '\n') 
# clean up 
f.close() 
print("ASCII art written to %s" % outFile) 


# call main 
if _name__ == ' main ': 
main() 


6.5 ”运行 ASCII 文 本 图 形 生 成 程序 


要 运行 编写 好 的 程序 ， 输 入 类 似 下 面 这 样 的 命 
令 ， 将 data/robot.jpg 蔡 换 为 你 想 使 用 的 图 像 文件 的 
相对 路 径 。 


$ python ascii.py --file data/robot.jpg --cols 100 


图 6-3 展 示 了 ASCII 文 本 图 形 ， 它 是 左 侧 的 
robot.jpg 的 结果 。 





图 6-3 ascii.py 的 运行 示例 


现在 ， 你 可 以 创建 自己 的 ASCII 文 本 图 形 了 ! 


6.6 小结 


在 这 个 项 目 中 ， 我 们 学 习 了 如 何 从 任意 的 输入 
图 像 生 成 ASCII 文 本 图 形 。 我 们 还 学 习 了 如 何 计算 
平均 亮度 值 ， 将 图 像 转换 成 灰 度 ， 以 及 如 何 基于 灰 
度 值 用 字符 蔡 换 一 小 块 图 像 。 创 建 自己 的 ASCIIX 
本 图 形 ， 祝 你 玩 得 开心 ! 








6.7 ER 


这 里 有 一 些 想 法 ， 可 以 进一步 探索 ASCII 文 本 
图 形 。 


1. 用 命令 行 选项 --scale1.0 运 行 该 程序 。 和 生成 
的 图 像 看 起 来 如 何 ? 实验 不 同 的 Scale 值 。 将 输出 复 
制 到 一 个 文本 编辑 器 ， 和 尝试 设置 不 同 的 (固定 宽 
BE) 字体 ， 看 看 这 样 做 如 何 有 影响 最 终 图 形 的 外 观 。 


2. 为 程序 添加 命令 行 选 项 --invert， 反 转 ASCII 
文本 图 形 的 输入 值 ， 使 黑色 变 成 白色 ， 反 之 亦 然 
(提示 : 在 查找 时 用 255 减 去 小 块 的 亮度 值 ) 。 

3. 在 这 个 项 目 中 ， 基 于 两 个 字符 硬 编 码 的 梯 
度 创 建 灰 度 值 查找 表 。 实 现 一 个 命令 行 选项 ， 用 不 
同 的 字符 梯度 来 创建 ASCII 文 本 图 形 ， 就 像 这 样 : 











python3 ascii.py --map "@$%^`." 


前 面 这 样 的 梯度 用 给 定 的 6 个 字符 梯度 ， 创 建 
了 一 个 ASCTI 输 出 ， 其 中 “@* 映 射 到 亮度 值 0，“”* 映 
射 到 亮度 值 255。 





我 在 六 年 级 时 ， 看 到 一 张 类 似 图 7-1 的 图 像 ， 
但 不 太 明 白 它 是 什么 。 睐 看 眼睛 看 了 一 阵 后 ， 我 终 
于 想 通 了 把 书 倒 过 来 ， 离 远 一 反 看 它 。 


照 厂 马 赛 殉 是 一 张 图 像 ， 它 被 分 割 成 长 方形 的 
网 格 ， 每 个 长 方形 由 男 一 张 下 配 “ 目 标 ” 的 图 像 (最 
终 和 希望 出 现在 照片 马赛 元 中 的 图 像 ) 符 代 。 换 言 
之 ， 如 打从 远 处 看 照片 马赛 兄 ， 会 看 到 目标 图 像 ; 
Rr xac 
图 像 。 


这 个 迷 题 有 解 是 因为 人 眼 的 工作 方式 。 图 7-1 








HERS RBA AR, SEU SIR MEW al, {OR 
从 远 处 看 ， 束 知道 它 代表 什么 ， 因 为 看 到 的 细 市 较 
少 ， 融 使 得 边缘 越 光 滑 。 照 户 马 赛 死 的 原理 是 相似 
的 。 从 远 处 看 ， 图 像 看 起 来 正常 ， 但 走 近 时 ， 秘 密 
揭 开 了 : 每 “ 块 * 部 是 一 个 独特 的 图 像 ! 


本 项 目 中 ， 我 们 将 学 习 如 何 用 Python 创建 照 亡 
马赛 殉 。 我 们 将 目标 图 像 划 分 成 较 小 图 像 的 网 格 ， 
并 用 适当 的 图 像 蔡 换 网 格 中 的 每 一 小 块 ， 创 建 原始 
图 像 的 照片 马赛 珊 。 你 可 以 指定 网 格 的 太 寸 ， 并 选 
择 输入 几 像 是 个 可 以 在 马赛 元 中 重复 使 用 。 


在 这 个 项 目 中 ， 你 将 学 习 如 何 做 到 以 下 几 扣 : 





























。 用 Python 图 像 库 (PIL) 创建 图 像 ; 

。 计 算 图 像 的 平均 RGB 值 ; 

. SAK: 

。 通 过 粘贴 另 一 张 图像 来 蔡 代 原 图 像 的 一 部 分 
。 利 用 平均 距离 测量 来 比较 RGB 值 。 





图 7-1 令 人 费解 的 图 像 


7.1 工作 原理 


要 创建 照 厂 马赛 元 ， 就 从 目标 图 像 的 块 状 低 分 
辩 率 版 本 开始 (因为 在 蜗 分 辨 率 的 图 像 中 ， 小 块 图 
像 的 数量 会 太 大 ) 。 访 图像 的 分 辨 率 将 决定 马赛 元 
的 维度 MxN (M 是 行 数 ，N 是 列 数 ) 。 接 着 ， 根 据 
这 种 方法 葵 换 原始 图 像 中 的 每 一 小 块 : 

1. 读 入 一 些小 块 图 像 ， 它 们 将 取代 原始 图 像 
中 的 小 块 ; 

2. 读 入 目标 图 像 ， 将 它 分 割 成 MxN 的 小 块 网 
格 ; 

3. 对 于 每 个 小 块 ， 从 输入 的 小 块 图 像 中 找到 
最 佳 匹 配 ; 

4. 将 选择 的 输入 图 像 安排 在 MxN 的 网 格 中 ， 
创建 最 终 的 照片 马 冤 元 。 


7.1.1 分 割 目标 图 像 


按照 图 7-2 中 的 方案 ， 开 始 将 目标 图 像 划 分 成 
MxN 的 网 格 。 
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图 7-2 ”分 割 目标 图 像 


图 7-2 中 的 图 像 展 示 了 如 何 将 原始 图 像 分 割 成 
小 块 的 网 格 。x 轴 表示 网 格 的 列 ，y 轴 表示 网 格 的 
行 。 

现在 ， 看 看 如 何 计 算 网 格 中 一 个 小 块 的 坐标 。 
TRA G, j) 的 小 块 ， 左 上 角 坐 标 为 (isw, ir), A 
下 角 坐 标 为 (i+TDJ*w，(j+Dxh)， 其 中 w 和 h 分 别 是 小 
块 的 宽度 和 高 度 。PIL 可 以 用 这 些 数 据 ， 从 原 图 像 
创建 小 块 。 





7.1.2 FINE 


图 像 中 的 每 个 像素 都 有 颜色 ， 由 它 的 红 、 绿 、 
殴 值 来 表示 。 在 这 个 例子 中 ， 使 用 8 位 的 图 像 ， 因 
此 每 个 部 分 有 8 位 值 ， 范 围 在 [0,255]。 如 果 一 幅 图 
像 共有 N 个 像素 ， 平 均 RGB 计 算 如 下 : 


ri Tyee hate ae 
r,g.b Um. V —m 9» A 


请 注意 ， 平 均 RGB 也 是 一 个 三 元 组 ， 不 是 标量 
或 一 个 数字 ， 因 为 平均 值 是 针对 每 个 颜色 成 分 分 别 
计算 的 。 计 算 平 均 RGB 是 为 了 匹配 图 像 小 块 和 目标 
图 像 。 


7.1.3 ”匹配 网 像 


对 于 目标 图 像 中 的 每 个 小 块 ， 需 要 在 用 户 指定 
的 输入 文件 夹 的 一 些 图 像 中 ， 找 到 一 幅 匹 配 的 图 
像 。 要 确定 两 个 图 像 是 否 匹 配 ， 就 使 用 平均 RGB 
值 。 最 接近 的 匹配 就 是 最 接近 平均 RGB 值 的 图 像 。 


要 做 到 这 一 点 ， 最 简单 的 方法 是 计算 一 个 像素 
PR. eae 以 便 从 输入 图 像 中 找到 最 佳 
EL ETUR RIPE n 
算 方 法 : 




















ir Ir T ae 2 
Dia = y (r1 — 72) + (gi — ga)” + (b1 — 69) 


这 里 计算 了 点 (7 1,9 1,b1) 和 (r 5,g 5,b>) 之 间 
的 距离 。 给 定 一 个 目标 图 像 的 平均 RGB 值 ， 以 及 来 
目 输 入 图 像 的 平均 RGB 值 列表 ， 你 可 以 使 用 线性 搜 
过 和 三 维 点 的 距离 计算 ， 来 找到 最 匹配 的 图 像 。 





7.2 ”所 需 模块 


这 个 项 目 将 使 用 Pillow 读 入 图 像 ， 访 问 其 底层 
数据 ， 创 建 和 修改 图 像 。 还 会 用 numpy 来 操作 图 像 
数据 。 





ee 


站 和 完 读 入 那些 小 块 图 像 ， 它 们 将 用 于 创建 照 厂 
马赛 元 。 接 下 来 ， 计 算 图 像 的 平均 RGB 值 ， 然 后 将 
目标 图 像 分 割 成 图 像 网 格 ， 为 小 块 找 到 最 佳 匹 配 。 
Ba, ARAB DER, BRAM A soe. H 
得 看 完整 的 项 目 代 码 ， 请 直接 跳 到 7.4 节 。 


731 读 入 小 块 图 像 


首先 ， 从 给 定 的 文件 夹 中 读 入 输入 图 像 。 下 面 
是 具体 做 法 : 


def getImages(imageDir ): 
nn 
given a directory of images, return a list of Images 


@ files = os.listdir(imageDir) 
images - [] 
for file in files: 


e 
filePath - os.path.abspath(os.path.join(imageDir, file)) 
try: 


# explicit load so we don't run into resource crunch 
fp = open(filePath, "rb") 
im - Image.open(fp) 
images.append(im) 
# force loading the image data from file 


o im.load() 
# close the file 
e fp.close() 


except: 


# skip 
print("Invalid image: %s" % (filePath,)) 
return images 


在 @ 行 ， 用 os.listdir() 将 imageDir 目 录 中 的 文件 
DAPI. FE RR, TEA ZEA BED IC 
件 ， 将 它 载 入 一 个 PIL ImageX] £.. 


Tre). Fos.path.abspath()los.path.join)* 
获取 图 像 的 完整 文件 名 。 这 个 习惯 用 法 在 Python 中 
经 党 使 用 ， 以 确保 代码 既 能 在 相对 路 径 下 工作 《如 
\foo\bar) ， 也 能 在 绝对 路 径 下 工作 
(c:\foo\bar\) ， 并 且 能 路 操作 系统 ， 不 同 的 操作 系 
统 有 不 同 的 目录 命名 惯例 (Windows 用 \ 而 Linux 
FAD 。 


要 将 文件 加 载 为 PIL 的 Image 对 象 ， 可 以 将 每 个 
文件 名 传 入 Image.open() 方 法 ， 但 如 果 照 请 马 完 殉 
文件 夹 中 有 几 百 张 甚至 几 干 张 图 片 ， 这 样 做 非常 消 
耗资 源 。 作 为 蔡 代 ， 可 以 用 Python 打开 每 个 小 块 图 
像 ， 利 用 Image.open0 将 文件 句柄 印 传 入 PILO。 图 
像 加 载 后 ， 关 闭 文件 句柄 并 释放 系统 资源 。 


在 个 行 ， 用 open0 打 开 图 像 文 件 。 在 随后 的 几 
行 中 ， 将 文件 句柄 传 入 Image.open0， 将 得 到 的 图 
像 im 存 入 一 个 数组 。 


因为 open0 是 一 个 惰性 操作 ， 所 以 在 个 行 调用 








Image.load0， 强 制 加 载 im 中 的 图 像 数 据 。 它 确定 了 
图 像 ， 但 实际 上 没有 读 取 全 部 图 像 数 据 ， 直 到 符 试 
使 用 该 图 像 的 时 候 才 会 那么 做 。 


在 信行 ， 关 闭 文 件 句柄 ， 释 放 系 统 资 源 。 
732 ”计算 输入 图 像 的 平均 颜色 值 


该 入 输入 网 像 后 ， 需 要 计算 它们 的 平均 颜色 
值 ， 以 及 目标 图 像 中 的 每 个 小 块 的 值 。 创 建 一 个 方 
法 getAverageRGB() 来 计算 这 两 个 值 。 


def getAverageRGB(image): 


return the average color value as (r, g, b) for each input im 
# get each tile image as a numpy array 

@ im = np.array(image) 
# get the shape of each input image 

 w,h,d = im.shape 
# get the average RGB value 

& return tuple(np.average(im.reshape(w*h, d), axis-0)) 


在 @ 行 ， 用 numpy 将 每 个 Image 对 象 转换 为 数 
据 数 组 。 返 回 的 numpy 数 组 形 为 (w, h, d)， 其 中 ，w 
是 图 像 的 宽度 ，h 是 高 度 ，d 是 深度 ， 在 这 个 例子 
中 ， 是 RGB 图 像 的 3 个 单位 〈 分 别 对 应 R，G 和 
B) 。 在 信行 保存 shape 元 组 ， 然 后 计算 平均 RGB 
值 ， 将 这 个 数组 变形 为 更 方便 的 形状 (w*h， d), X 
样 就 可 以 用 numpy.average() 计 算出 使 用 平均 值 。 


7.3.3. 将 目标 图 像 分 割 成 网 格 


现在 ， 需 要 将 目标 图 像 分 割 成 MxN 网 格 ， 包 
含 更 小 的 图 像 。 让 我 们 创建 一 个 方法 来 实现 。 


def splitImage(image, size): 


given the image and dimensions (rows, cols), return an m*n li 
"mW 


@ w, H = image.size[0], image.size[1] 
© m, n = size 
® w, h = int(W/n), int(H/m) 

# image list 

imgs = [] 

# generate a list of dimensions 

for j in range(m): 

for i in range(n): 
# append cropped image 

o imgs.append(image.crop((i*w, j*h, (i+1)*w, (j+1)*h))) 

return imgs 





首先 ， 在 @@ 行 得 到 目标 图 像 的 维度 ， 在 信行 得 
到 尺寸 。 在 全 行 ， 用 基本 除法 计算 目标 图 像 中 每 一 
小 块 的 尺寸 。 

现在 ， 需 要 达 代 亿 历 网 格 的 维度 ， 分 割 并 将 每 
一 小 块 保存 为 单独 的 图 像 。 在 全 行 ，image.crop() 利 
用 左上 角 图 像 坐 标 和 裁 是 图像 的 维度 作为 参数 ， 配 
裁 出 图 像 的 一 部 分 (在 7.1.1 小 节 中 讨论 ) 。 


734 “寻找 小 块 的 最 佳 匹 配 








现在 ， 让 我 们 从 输入 图 像 的 文件 夹 中 ， 找 到 小 
块 的 最 佳 匹 配 。 创 建 一 个 工具 方法 
getBestMatchIndex(), 40 FATA: 


def getBestMatchIndex(input_avg, avgs): 


return index of the best image match based on average RGB val 


# input image average 
avg = input_avg 


# get the closest RGB value to input, based on RGB distance 
index = 0 
@ min_index = 0 
min dist = float("inf") 
& for val in avgs: 
o dist = ((val[0] - avg[0])*(val[0] - avg[0]) + 
(val[1] - avg[1])*(val[1] - avg[1]) + 
(val[2] - avg[2])*(val[2] - avg[2])) 
® if dist < min_dist: 
min_dist = dist 
min_index = index 
index += 1 


return min_index 


需要 从 列表 avgs 中 ， 找 到 最 匹配 平均 RGB 值 
input_avg 的 。avgs 古 小 块 图 像 平 均 RGB 值 的 列表 。 


为 了 找到 最 佳 匹配 ， 比 较 这 些 输 入 图 像 的 平均 
RGB 值 。 在 代行 和 仿 行 ， 将 最 接近 的 匹配 下 标 初始 
化 为 0， 基 小 距离 初始 化 为 无 穷 信 。 访 测试 在 第 一 

次 总 是 会 通过 ， 因 为 任何 距离 都 小 于 无 穷 大 。 在 合 


行 ， 珊 历 平均 值 列 表 中 的 值 ， 并 开始 在 @ 行 用 标准 
公式 计算 距离 《比较 距离 的 平方 ， 以 减少 计算 时 
HD 。 在 信行， 如 果 计 算 的 距离 小 于 保存 的 最 小 距 
离 min_dist， 它 束 被 普 换 为 新 的 最 小 距离 。 迭 代 结 
束 时 ， 就 得 到 了 平均 RGB 值 列 表 args 中 ， 最 接近 
input _avg 的 下 标 。 现 在 可 以 利用 这 个 下 标 ， 从 小 块 
图 像 的 列表 中 选择 逻 配 的 小 块 图 像 了 。 


735 ”创建 图 像 网 格 


在 继续 创建 照片 马 弗 元 之 前 ， 还 需要 一 个 工具 
方法 。createImageGrid() 方 法 将 创建 大 小 为 MxN 的 
图 像 网 格 。 这 个 图 像 网 格 是 最 终 的 照片 马 冤 元 图 
像 ， 利 用 选择 的 小 块 图 像 列表 来 创建 。 








def createImageGrid(images, dims): 


given a list of images and a grid size (m, n), create a grid 
@ m, n = dims 


# sanity check 
assert m*n == len(images) 


# get the maximum height and width of the images 
# don't assume they're all equal 

@ width = max([img.size[0] for img in images]) 
height = max([img.size[1] for img in images] ) 


# create the target image 
@ grid img = Image.new('RGB', (n*width, m*height) ) 


# paste the tile images into the image grid 
for index in range(len(images) ): 
@ row = int(index/n) 


® col = index - n*row 
grid img.paste(images[index], (col*width, row*height)) 


return grid img 


在 @ 行 ， 取得 网 格 的 尺寸 ， 然后 用 assert 检 
查 ， 提 供给 createImageGrid0 的 图 像 数量 是 否 符合 
网 格 的 大 小 (assert 方 法 检查 代码 中 的 假定 ， 特 别 是 
在 开发 和 测试 过 程 中 的 假定 ) 。 现 在 你 有 一 个 小 块 
图 像 列 表 ， 基 于 最 接近 的 RGB 值 ， 你 将 用 它 来 创建 
— I AVR, KUH HAT. TAD, RE 
选 定 的 图 像 可 能 不 会 正好 填充 一 个 小 块 ， 但 这 不 会 
是 一 个 问题 ， 因 为 你 首先 用 黑色 背景 填充 小 块 。 


在 信行 和 下 面 一 行 ， 计 算 小 块 图 像 的 最 大 宽度 
和 局 度 〈 你 没有 对 选择 的 输入 图 像 的 大 小 做 出 任何 
假定 ， 无 论 它 们 相同 或 不 同 ， 代 码 都 能 工作 ) ， 如 
RBA BA Be oe HR SINE INE TRES] ZR TREE 
显示 为 背景 色 ， 默 认 是 黑色 。 


在 信行 ， 创 建 一 个 空 的 Image， 大 小 符合 网 格 
中 的 所 有 图 像 。 小 块 图 像 会 粘贴 到 这 个 图 像 。 然 后 
TA AAPM. FEO, Hee Fite AMR, A 
用 Image.paste0) 方 法 ， 将 它们 粘贴 到 相应 的 网 格 
中 。Image.paste0 的 第 一 个 参数 是 要 粘贴 的 Image 对 
象 ， 第 二 个 参数 是 左上 角 的 坐标 。 现 在 ， 你 需要 搞 
清楚 小 块 图 像 要 粘贴 到 图 像 网 格 的 行 和 列 。 为 了 做 























到 这 一 





扩 ， 将 图 像 下 标 表 示 为 行 和 列 。 小 块 在 图 像 


ee + col] 给 出 ， 其 中 N 是 一 行 的 
小 块 数 ，(row，col) 是 在 该 网 格 中 的 坐标 。 在 @ 行 ， 
利用 前 面 的 公式 给 出 行 ， 全 行 给 出 了 列 。 


7.3.6 ”创建 照片 马赛 克 


现在 ， 有 了 所 有 必需 的 工具 方法 ， 让 我 们 编写 
“Smainek 20, £g Ha Fr D 3€ vu. 


def createPhotomosaic(target image, input images, grid size, 


© 00 © 


creates a photomosaic given target and input images 


print('splitting input image...') 
# split the target image into tiles 
target images - splitlImage(target image, grid size) 


print('finding image matches...') 

# for each tile, pick one matching input image 

output images - [] 

# for user feedback 

count - 0 

batch size - int(len(target images)/10) 

# calculate the average of the input image 

avgs - [] 

for img in input images: 
avgs.append(getAverageRGB( img) ) 


for img in target_images: 
# compute the average RGB value of the image 
avg = getAverageRGB(img) 
# find the matching index of closest RGB value 
# from a list of average RGB values 
match_index = getBestMatchIndex(avg, avgs) 
output images.append(input images[match index]) 
4 user feedback 


if count > 0 and batch size > 10 and count % batch size is ®: 
print('processed ?6d of %d...' % 
(count, len(target_images))) 
count += 1 
# remove the selected image from input if flag set 
e if not reuse images: 
input images.remove(match) 


print('creating mosaic...') 
# create photomosaic image from tiles 
Q mosaic image = createlImageGrid(output images, grid size) 


# display the mosaic 
return mosaic image 





createPhotomosaic() 方 法 的 输入 是 目标 图 像 、 
输入 图 像 列 表 、 生 成 照 记 马赛克 的 大 小 ， 以 及 一 个 
标志 ， 该 标志 表明 图 像 是 否 可 以 复 用 。 在 @ 行 ， 它 
将 目标 图 像 分 割 成 一 个 网 格 。 图 像 被 分 割 后 ， 针 对 
每 个 小 块 ， 从 输入 文件 夹 中 寻找 匹配 的 图 像 ( 因 为 
这 个 过 程 可 能 很 长 ， 所 以 提供 反馈 给 用 户 ， 让 他 们 
知道 程序 仍 在 工作 ) 。 


在 信行 ， 将 batch_size 设 置 为 小 块 图 像 总 数 的 
分 之 一 。 在 @@ 行 ， 该 变量 将 用 于 向 用 户 更 新 信息 
(选择 十 分 之 -EALBH, He peers 
Ji: “我 还 活着 。” 每 次 程序 处 处 理 了 图 像 的 十 分 
一 ， 就 打印 一 条 消息 ， 表 明 它 仍 在 运行 ) 。 


在 候 行 ， 为 输入 文件 夹 中 的 每 个 图 像 计 算 平 均 
RGB 值 ， 并 保存 在 列表 avgs 中 。 然 后 ， 开 始 迭 代 人 遍 
历 目标 图 像 网 格 中 的 每 个 小 块 。 对 于 每 个 小 块 ， 计 























算 平均 RGB 值 @@。 然 后 ， 在 全 行 ， 在 输入 图 像 的 平 
均值 列表 中 ， 寻 找 该 值 的 最 佳 匹 配 。 返 回 的 结果 是 
EE 在 @ 行 用 它 取 得 Image 对 象 ， 并 保存 在 
列表 中 。 


在 人 @ 行 ， 每 处 理 batch_size 个 图 像 ， 就 为 用 户 
打印 一 条 消息 。 在 信行 ， 如 果 reuse_images 标 志 设 
置 为 False， 束 从 列表 中 删除 选 定 的 输入 图 像 ， 这 样 
就 不 会 在 男 一 个 小 块 中 重用 (如 果 有 广泛 的 输入 图 
像 可 选 ， 这 种 方式 效果 最 好 ) . mun. OT, 4 
合 图 像 创 建 最 终 的 照片 马赛 死 。 


7.3.7” 湛 加 命令 行 选项 
该 程序 的 main() 方 法 文 持 这 些 命令 行 选项 ; 








# parse arguments 


parser - argparse.ArgumentParser(description-'Creates a photo 
input images') 

# add arguments 
parser.add argument('--target- 

image', dest-'target image', required-True) 
parser.add argument('--input- 

folder', dest-'input folder', required-True) 
parser.add argument('--grid- 

size', nargs-2, dest-'grid size', required=True) 
parser.add argument('--output- 

file', dest-'outfile', required-False) 


这 段 代码 包含 3 个 必需 的 命令 行 参数 : 目标 图 
像 的 名 称 、 输 入 图 像 文件 夹 的 名 称 ， 以 及 网 格 尺 


寸 。 第 4 个 参数 是 可 选 的 文件 名 。 如 果 省 略 该 文件 
名 ， 照 厂 蕊 者 元 将 写 入 文件 mosaic.png。 


7.8.8 fen He STINK) 


TEE APE ED] tc Jig — 1 I8] ea HRA FS EEN) 
如 果 基 于 目标 图 像 中 匹配 的 小 块 ， 讶 目地 将 输入 图 
像 粘贴 在 一 起 ， 束 会 得 到 一 个 巨大 的 照片 马 替 元 ， 
比 目 标 图 像 大 得 多 。 为 了 避免 这 种 情况 ， 调 整 输 入 
图 像 的 大 小 ， 以 匹配 网 格 中 每 个 小 块 的 大 小 (这 样 
做 还 有 一 个 好 处 ， 可 以 加 快 平均 RGB 的 计算 ， 因为 
用 了 较 小 的 图 像 ) 。main0) 方 法 也 进行 这 样 的 处 
JH. 





print('resizing images...') 


# for given grid size, compute the maximum width and height o 
dims - (int(target image.size[0]/grid size[1]), 
int(target image.size[1]/grid size[0])) 
print("max tile dims: %s" 96 (dims,)) 
# resize 
for img in input images: 
(2) img.thumbnail(dims) 


在 @ 行 ， 根 据 指定 的 网 格 大 小 ， 计 算 目 标 图 像 
的 维度 。 随 后 ， 在 信行 ， 用 PIL Image.thumbnail() 方 
法 来 调整 图 像 ， 以 适应 网 格 的 大 小 。 
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项 目的 完整 代码 可 以 在 
https://github.com/electronut/pp/tree/master/photomosa 
photomosaic.py# 4] . 


import sys, os, random, argparse 
from PIL import Image 

import imghdr 

import numpy as np 


def getAverageRGB(image): 


return the average color value as (r, g, b) for each input im 


# get each tile image as a numpy array 

im - np.array(image) 

# get the shape of each input image 

w,h,d = im.shape 

# get the average RGB value 

return tuple(np.average(im.reshape(w*h, d), axis-0)) 


def splitImage(image, size): 


given the image and dimensions (rows, cols), returns an m*n 1 


W, H - image.size[0], image.size[1] 
m, n = size 
w, h = int(W/n), int(H/m) 


# image list 
imgs - [] 
# generate a list of dimensions 
for j in range(m): 
for i in range(n): 
# append cropped image 


imgs.append(image.crop((i*w, j*h, (i*1)*w, (j+1)*h))) 
return imgs 


def getImages(imageDir ): 


given a directory of images, return a list of Images 
files = os.listdir(imageDir) 

images = [] 

for file in files: 


filePath - os.path.abspath(os.path.join(imageDir, file)) 
try: 


# explicit load so we don't run into a resource crunch 
fp = open(filePath, "rb") 
im - Image.open(fp) 
images.append(im) 
# force loading image data from file 
im.load() 
# close the file 
fp.close() 
except: 

# skip 
print("Invalid image: %s" % (filePath,)) 

return images 


def getImageFilenames(imageDir ): 


given a directory of images, return a list of image filenames 
files = os.listdir(imageDir) 
filenames = [] 
for file in files: 


filePath = os.path.abspath(os.path.join(imageDir, file)) 
try: 
imgType = imghdr.what(filePath) 
if imgType: 
filenames.append(filePath) 
except: 
# skip 
print("Invalid image: %s" % (filePath,)) 
return filenames 


def getBestMatchIndex(input_avg, avgs): 


return index of the best image match based on average RGB val 


# input image average 
avg - input avg 


# get the closest RGB value to input, based on RGB distance 
index - 0 
min index = 0 
min dist - float("inf") 
for val in avgs: 
dist = ((val[0] - avg[0])*(val[0] - avg[0]) + 
(val[1] - avg[1])*(val[1] - avg[1]) + 
(val[2] - avg[2])*(val[2] - avg[2])) 
if dist « min dist: 
min dist - dist 
min index - index 
index += 1 


return min index 


def createlmageGrid(images, dims): 


given a list of images and a grid size (m, n), create a grid 


m, n = dims 


# sanity check 
assert m*n -- len(images) 


# get the maximum height and width of the images 
# don't assume they're all equal 

width = max([img.size[0] for img in images]) 
height - max([img.size[1] for img in images]) 


# create the target image 
grid img - Image.new('RGB', (n*width, m*height)) 


# paste the tile images into the image grid 
for index in range(len(images)): 
row = int(index/n) 
col - index - n*row 
grid img.paste(images[index], (col*width, row*height)) 


return grid img 


def createPhotomosaic(target image, input images, grid size, 


creates photomosaic given target and input images 


print('splitting input image...') 
# split the target image into tiles 
target images = splitlImage(target image, grid size) 


print('finding image matches...') 

# for each tile, pick one matching input image 
output images - [] 

# for user feedback 

count - 0 

batch size - int(len(target images)/10) 


# calculate the average of the input image 

avgs - [] 

for img in input images: 
avgs.append(getAverageRGB( img) ) 


for img in target_images: 
# compute the average RGB value of the image 
avg = getAverageRGB(img) 
# find the matching index of closest RGB value 
# from a list of average RGB values 
match_index = getBestMatchIndex(avg, avgs) 
output images.append(input images[match index]) 
# user feedback 


if count > 0 and batch size > 10 and count % batch size is 0: 
print('processed ?6d of 96d. ..' % 
(count, len(target_images))) 
count += 1 
# remove the selected image from input if flag set 
if not reuse_images: 
input_images.remove(match) 


print('creating mosaic...') 
# create photomosaic image from tiles 
mosaic_image = createlmageGrid(output_images, grid_size) 


# display the mosaic 
return mosaic_image 


# gather our code in a main() function 


def main(): 
# command line arguments are in sys.argv[1], sys.argv[2], 


# sys.argv[0] is the script name itself and can be ignored 
# parse arguments 


parser = argparse.ArgumentParser(description='Creates a photo 
input images' ) 

# add arguments 
parser .add_argument('--target- 

image', dest='target_image', required=True) 
parser .add_argument('--input- 

folder', dest='input_folder', required=True) 
parser.add argument('--grid- 

size', nargs-2, dest-'grid size', required-True) 
parser.add argument('--output- 

file', dest-'outfile', required-False) 


args - parser.parse args() 
THHHHH INPUTS FHHHHHE 


# target image 
target image - Image.open(args.target image) 


# input images 
print('reading input folder...') 
input images = getliImages(args.input folder) 


# check if any valid input images found 
if input images -- []: 


print('No input images found in %s. Exiting.' % (args.input f 
exit() 


# shuffle list to get a more varied output? 
random.shuffle(input images) 


# size of the grid 

grid size = (int(args.grid size[0]), int(args.grid size[1])) 
# output 
output filename - 'mosaic.png' 


if args.outfile: 
output filename - args.outfile 


# reuse any image in input 
reuse images - True 


# resize the input to fit the original image size? 
resize input - True 


HHH END INPUTS #HHHH 
print('starting photomosaic creation...') 


# if images can't be reused, ensure m*n «- num of images 
if not reuse images: 
if grid size[0]*grid size[1] » len(input images): 
print('grid size less than number of images') 
exit() 
# resizing input 
if resize input: 
print('resizing images...') 


# for given grid size, compute the maximum width and height o 
dims - (int(target image.size[0]/grid size[1]), 
int(target image.size[1]/grid size[0])) 
print("max tile dims: %s" 96 (dims,)) 
# resize 
for img in input images: 
img.thumbnail(dims) 


# create photomosaic 


mosaic image - createPhotomosaic(target image, input images, 
reuse images) 


# write out mosaic 
mosaic image.save(output filename, 'PNG') 


print("saved output to %s" % (output filename, ) ) 
print('done.') 


# standard boilerplate to call the main() function 
# to begin the program 
if _name__ == ' main ': 

main() 


Hh 53€». TE (c) 


yd 
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7.5 运行 照片 马赛 死生 成 程序 


下 面 是 该 程序 的 运行 示例 : 


$ python photomosaic.py --target-image 
data/cherai.jpg --input-folder 
test-data/set6/ --grid-size 128 128 
reading input folder... 

starting photomosaic creation... 
resizing images... 

max tile dims: (23, 15) 

splitting input image... 

finding image matches... 

processed 1638 of 16384 ... 
processed 3276 of 16384 ... 
processed 4914 of 16384 ... 
creating mosaic... 

saved output to mosaic.png 

done. 








test- 


图 7-3 (a) ER SAMAR, b) 展示 了 照 


可 以 看 到 照 记号 才 克 的 特 
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在 这 个 项 目 中 ， 我 们 学 习 了 如 何 利用 给 定 的 目 
RERAMA RR, MEARE. MA 
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7.7. Seay 
这 里 有 一 些 方式 ， 可 以 进一步 探索 照片 马赛 


1. 编写 一 个 程序 ， 创 建 图像 的 块 状 版 本 ， 类 
似 图 7-1。 


2. 利用 本 章 的 代码 ， 通 过 粘贴 匹配 的 图 像 创 
建 照 片 马 赛 元 ， 小 块 图 像 之 间 没 有 间 际 。 更 艺术 的 
表现 形式 ， 是 在 每 个 小 块 图 像 之 间 留 出 几 个 像素 的 
均匀 间 际 。 如 何 创建 这 样 的 间 际 (提示 : 在 计算 最 
终 的 图 像 尺 寸 以 及 在 createImageGrid() 中 粘贴 时 ， 
考虑 间 际 的 因素 )〉 ? 


3. 程序 的 大 部 分 时 间 ， 用 于 从 输入 文件 夹 中 
寻找 小 块 图 像 的 最 佳 匹 配 。 为 了 加 快 程序 ， 
getBestMatchIndex() 需 要 运行 得 更 快 。 这 个 方法 是 
对 平均 值 〈 看 成 三 维 的 点 ) 列表 进行 简单 的 线性 搜 
索 。 这 个 任务 的 一 般 问 题 就 是 最 近邻 大 搜索 。 找 到 
最 近 点 有 一 种 特别 有 效 的 方法 ， 即 K-D 树 搜索 。 
SciPy 库 有 一 个 方便 的 类 scipy.spatial.KDTree， 可 以 
创建 K-D 并 同 它 查询 最 近 点 的 匹配 。 请 尝试 用 SciPy 
的 K-D 树 蔡 代 线性 搜索 〈 人 参见 
http://docs.scipy.org/doc/scipy/reference/generated/ 











scipy.spatial.KDTree.html) . 


第 8 章 ”三 维 立 体 男 





盯 痢 图 8-1 看 一 分 钟 。 除 了 随机 的 点 ， 你 还 看 
到 别 的 什么 吗 ? 图 8-1 是 一 张 三 维 立 体 画 ， 是 制造 
三 维 假象 的 二 维 图 像 。 三 维 立 体 画 通常 包含 一 些 重 
复 的 图 案 ， 人 和 仔 细 观 察 会 被 大 脑 解释 为 三 维 。 如 果 你 
看 不 到 任何 图 像 效 果 ， 别 担心 。 我 也 花 了 一 段 时 
间 ， 做 了 一 些 答 试 ， 才 能 看 到 《如 采 你 在 本 书 的 印 
刷 版 本 上 看 不 到 ， 请 在 这 里 尝试 彩色 的 版 本 : 
https://github.com/electronut/pp/images/。 标 题 的 脚注 
提示 了 你 应 该 看 到 的 图 像 ) 。 


本 项 目 将 用 Python 创 建 一 张 三 维 立体 夯 。 下 面 
是 本 项 目 涉 及 的 一 些 概念 : 

















。 线 性 间距 和 深度 知觉 ; 
TREE; 

。 用 Pillow 创 建 和 编辑 图 像 ; 
。 用 Pillow 绘 制图 像 。 


本 项 目 生 成 的 三 维 立 体 男 设计 为 用 "“ 播 眼 ?” 方 式 
观看 。 看 到 它们 的 最 好 方法 ， 束 是 让 眼睛 聚焦 在 图 
GORA E) 。 有 点 人 神奇， 一 旦 在 这 些 图 
案 中 感知 到 茶 样 东西 ， 眼 睛 就 会 自动 将 它 作为 关注 
的 焦点 ， 如 果 三 维 图 像 已 “锁定 ”， 你 很 难 对 它 视 而 
不 见 的 《如 果 你 仍然 无 法 看 到 图 像 ， 请 看 Gene 
Levin 的 文章 “How to View Stereograms and Viewing 
Practice” H, WA) 。 























图 8-1 一 张 令 人 费解 的 图 像 ， 可 能 让 你 


8.1 工作 原理 


三 维 立 体 画 的 工作 原理 是 改变 图 像 中 图 和 案 之 间 
的 线性 间距 ， 从 而 产生 深度 的 错觉 。 在 观看 三 维 并 
体 国 中 的 重复 图 案 时 ， 大 脑 会 将 间距 解释 为 深度 信 
恩 ， 如 果 有 多 个 图 委 和 不 同 的 间距 ， 尤 其 会 这 样 。 


8.1.1 感知 三 维 立 体 画 中 的 深度 


如 果 你 的 眼睛 汇聚 在 图 像 背 后 一 个 假想 的 点 ， 
大 脑 将 左 眼 看 到 的 一 些 点 与 右 眼 看 到 的 男 一 些 点 罗 
配 起 来 ， 你 将 会 看 到 这 些 点 位 于 图 像 之 后 的 一 个 平 
面 上 。 到 该 平面 的 感知 距离 取决 于 图 案 中 的 间距 的 
数量 。 例 如 ， 图 8-2 展 示 了 3 行 A。 这 些 A 每 行 间 的 中 
离 相 等 ， 但 它们 的 水 平 间 距 从 上 至 下 增加 。 


如 果 用 “ 墙 眼 ”的 方式 来 看 ， 图 8-2 中 最 上 面 一 
行 应 该 出 现在 纸 后 面 ， 中 间 行 应 该 看 起 来 像 在 第 一 
行 后 面 一 点 ， 底 部 一 行 应 该 出 现在 最 远 的 位 置 。 文 
本 “floating text” 应 该 看 起 来 “ 浮 在 ”这 几 行 项 部 。 


为 什么 大 脑 将 这 些 图 柔 的 间距 解读 为 深度 ? 38 
功 悄 况 下 ， 如 果 看 远 处 的 物体 ， 你 的 双眼 协作 ， 桶 
焦 并 汇聚 在 同一 点 ， 双 了 眼 回 内 转 ， 直 接 指 问 目 标 
上 态 。 但 用 “ 增 眼 ”方式 观看 三 维 立 体 画 了 时， 聚焦 和 汇 



































聚 发 生 在 不 同 的 位 置 。 眼 睛 专注 于 三 维 立 体 画 ， 但 
大 脑 将 重复 的 模式 看 成 来 自 同 一 个 虚拟 (虚构 的 ) 
对 象 ， 眼 睛 汇聚 在 图 像 背 后 的 一 个 点 ， 如 图 8-3 所 
示 。 解 耦 的 聚焦 和 汇聚 琶 加 在 一 起 ， 让 你 在 三 维 立 
体 画 中 看 到 深度 。 
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图 8-2 ”线性 间距 和 深度 知觉 


汇聚; 感知 到 的 立体 物体 


一 
重复 的 图 案 


眼睛 


汇聚; 真实 距离 的 物体 


眼睛 





图 8-3 ”在 三 维 立 体 国 中 看 到 深度 


三 维 立 体 画 的 感知 深度 取决 于 像 系 的 水 平 间 
中 。 因 为 图 8-2 中 的 第 一 行 具有 最 近 的 间 隅 ， 它 出 
现在 其 他 行 的 前 面 。 然 而 ， 如 果 操 的 间距 在 图 像 中 
征 变 化 的 ， 大 脑 将 认为 每 个 点 处 于 不 同 的 深度 ， 所 
以 我 们 会 看 到 一 个 虚拟 的 三 维 图 像 。 























“深度 图 ”是 这 样 一 幅 图 像 : 其 中 每 个 像 系 的 值 
表示 深 度 值 ， 即 从 眼睛 到 该 像素 表示 的 对 象 部 分 的 
距离 。 深 度 图 往往 表现 为 一 幅 灰 度 图 ， 完 的 区 域 表 
示 近 的 挟 ， 瞳 的 区 域 表 示 远 的 挟 ， 如 图 8-4 所 示 。 





图 8-4 深度 图 


注意 ， 阁 鱼 的 虱子 是 图 像 中 最 之 部 分 ， 似 乎 最 
接近 你 。 表 同 尾 部 的 较 暗 区 域 看 起 来 最 远 。 


因为 深度 图 表示 从 每 个 像素 中 心 到 眼睛 的 深度 
或 距离 ， 所 以 可 以 用 它 来 获得 与 图 像 中 像素 位 置 相 
关联 的 深度 值 。 我 们 知道 ， 在 图 像 中 ， 水 平 偏 移 被 
认为 是 深度 。 所 以 ， 如 末 按 照 对 应 像 系 值 深度 值 的 
Le pil, Kin AR) 图 像 中 的 像素 ， 束 会 对 该 像 
素 产 生 与 深度 图 一 致 的 深度 知觉 。 如 条 对 所 有 像素 
这 样 做 ， 最 终 融 会 将 整个 深度 图 编码 到 图 像 中 ， 生 
成 三 维 立 体 画 。 


深度 图 的 每 个 像素 存储 了 深度 值 ， 并 且 该 值 的 
分 辩 率 取决 于 表示 它 的 位 数 。 因 为 本 章 采 用 常见 的 
8 位 图 像 ， 深 度 值 的 范围 是 [0,255]。 

顺便 说 一 下 ， 图 8-4 中 的 图 像 就 是 用 于 创建 图 
8-1 中 的 三 维 立体 画 的 深度 图 。 你 很 快 就 能 学 会 自 
己 如 何 做 到 这 一 点 。 

该 项 目的 代码 将 遵循 以 下 步骤 : 

1. 该 入 深度 图 ; 

2. 读 入 一 幅 平 铺 图 像 或 创建 一 个 “随机 点 ” 平 
铺 图 像 ; 






































3. 通过 重复 平 铺 图 像 创 建 一 幅 新 图 像 。 该 图 
AMR SARA RE, 


4. 对 新 疼 像 中 的 每 个 像素 ， 根 据 该 像素 相关 
联 的 深度 值 ， 将 它 按 比 例 地 回 右 移 ; 


5. 将 三 维 立 体 男 写 入 一 个 文件 。 





8.2 ”所 需 模 块 


本 项 目 使 用 Pillow 读 取 图 片 ， 访 问 它们 的 底层 
数据 ， 创 建 和 修改 图 像 。 


8.3 NH 


为 了 从 输入 的 深度 图 生成 三 维 立 体 画 ， 首 先 重 











复 一 幅 给 定 的 平 铺 图 像 ， 生 成 一 幅 中 间 图 像 。 接 下 
来 ， 生 成 一 幅 元 满 随 机 点 的 平 铺 图 像 。 然 后 进入 生 


成 


三 维 立体 画 的 核心 代码 ， 即 利用 所 提供 的 深度 图 








中 的 信息 ， 移 动 输入 的 图 像 。 要 查看 完整 的 项 目 ， 
请 直接 跳 到 8.4 节 。 


8.3.1 重复 给 定 的 平 铺 图 像 


平 铺 


我 们 从 利用 createTiledImage0) 方 法 开始 ， 通 过 


一 个 图 形 文 件 ， 创 建 一 幅 新 的 图 人像。 图 像 尺 寸 





由 dims 元 组 指定 ， 访 元 组 形式 为 (width, height) 。 


# tile a graphics file to create an intermediate image of a s 
def createTiledImage(tile, dims): 


e 


eo 
e 


# create the new image 
img - Image.new('RGB', dims) 
W, H = dims 
w, h = tile.size 
# calculate the number of tiles needed 
cols - int(W/w) * 1 
rows = int(H/h) + 1 
# paste the tiles into the image 
for i in range(rows): 
for j in range(cols): 
img.paste(tile, (j*w, i*h)) 
# output the image 
return img 


在 @ 行 ， 利 用 提供 的 尺寸 dims) 创建 新 的 
Python 图 像 库 (PIL) Image 对 象 。 新 图 像 的 尺寸 由 
元 组 dims 给 出 ， 形 式 是 (width, height) 。 接 着 ， 保 
存 平 铺 图 像 和 输出 文件 的 宽度 和 高 度 。 在 信行 ， 确 
定 列 数 ， 在 信行， 确定 中 间 图 像 所 需 的 行 数 ， 方 法 
是 用 最 终 图 像 的 尺寸 除 以 平 铺 图 像 的 尺寸 。 队 的 结 
果 每 次 加 1， 如 有 果 输 出 图 像 的 尺寸 不 是 正好 是 平 铺 
图 像 的 整数 倍 ， 这 也 能 确保 右边 最 后 的 平 铺 图 像 不 
会 缺失 。 如 果 没 有 这 种 预防 措施 ， 图 像 的 右边 可 能 
RU. Aa EOT, ETMA, FHF 
铺 图 像 填 充 它 们 。 退 过 乘积 (*w，i*h)， 确 定 平 铺 图 
像 左 上 角 的 位 置 ， 这 样 它 能 对 准 行 和 列 。 完 成 后 ， 
回 指定 尺寸 的 Image 对 象 ， 用 输入 图 像 tile 
平 铺 。 


832 MEN EFFEKT 


如 果 用 户 不 提供 平 铺 图 像 ， 残 利用 
createRandomTile() 方 法 ， 用 随机 圆 较 创建 一 张 平 铺 
图 像 。 














# create an image tile filled with random circles 
def createRandomTile(dims): 
# create image 
@ img = Image.new('RGB', dims) 
draw - ImageDraw.Draw(img) 
# set the radius of a random circle to 1% of 
# width or height, whichever is smaller 
® r = int(min(*dims)/100) 
# number of circles 
© n = 1000 


# draw random circles 
for i in range(n): 
# 


r makes sure that the circles stay inside and aren't cut off 
# at the edges of the image so that they'll look better when 
x; y - random.randint(0, dims[0]- 
r), random.randint(0, dims[1]-r) 
fill = (random.randint(0, 255), random.randint(0, 255), 
random.randint(0, 255) ) 


(7) draw.ellipse((x-r, y-r, x*r, y+r), fill) 
return img 


在 @@ 行 ， 用 dim 给 出 的 尺寸 创建 新 的 Image 对 
象 。 用 ImageDraw.Draw() 9E iz Eg f Hel, FH 
宽 或 高 中 较 小 值 的 1100 作 为 半径 ， 画 圆圈 
© (Python 的 * 运 算 符 将 dim 元 组 中 的 宽度 和 高 度 值 
解 包 ， 这 样 束 能 传 入 到 min0 方 法 中 〉。 


在 @@ 行 ， 设 置 要 画 的 圆圈 数 为 1000。 然 后 调用 
random.randint(), 3Xf4 35 F8 ALO, width-r] 和 [0， 
height-r] 的 两 个 随机 整数 ， 从 而 算出 每 个 圆圈 的 x 和 
rag: “PRERA 保持 在 widthxheight 
HJ AMAXEJE PI SE. AN tr, 1 H IR] PS] RT He ER 
Wa, ALARE CAU Ba. GRAPE HPI 
的 图 像 来 创建 三 维 立 体 画 ， 结 果 不 会 好 看 ， 因 为 两 
个 平 铺 图 像 之 间 没 有 空间 。 


要 生成 一 个 随机 圆圈 ， 先 画 出 轮廓 ， 然 后 填充 
颜色 。 在 @ 行 ， 在 [0,255] 的 范围 内 随机 选取 RGB 
值 ， 用 选择 颜色 填充 。 最 后 ， 在 @@ 行 ， 用 draw 中 的 





























ellipse() 方 法 绘制 每 个 圆圈 。 该 方法 的 第 一 个 参数 是 
加 的 边界 矩形 ， 它 由 左上 角 和 右 下 和 角 指 定 ， 分 别 为 
(x-r, y-f) 和 (x+r, y+r)， 其 中 (x, y) 是 该 圆 的 圆心 ，r 是 
半径 。 


让 我 们 在 Python 解释 天 中 测试 这 种 方法 。 








>>> import autos 


>>> img = autos.createRandomTile((256, 256)) 
>>> img.save('out.png') 
>>> exit() 


图 8-5 展 示 了 测试 的 输出 。 





48-5 Site 47TcreateRandomTile() 


正如 你 在 图 8-5 中 看 到 的 ， 我 们 已 经 创建 了 随 
机 挟 的 平 铺 图 像 。 可 以 使 用 它 来 创建 的 三 维 立体 
IH] o 





833 创建 三 维 立 体 画 


现在 ， 让 我 们 创建 一 些 三 维 芯 体 男 。 





createAutostereogram() 方 法 完成 了 大 部 分 工作 ， 如 
RATAN: 


def createAutostereogram(dmap, tile): 


e 


# convert the depth map to a single channel if needed 
if dmap.mode is not 'L': 
dmap - dmap.convert('L') 


# if no image is specified for a tile, create a random circle 
@ if not tile: 


e 
© 


tile = createRandomTile((100, 100)) 
# create an image by tiling 
img = createTiledImage(tile, dmap.size) 
# create a shifted image using depth map values 
SImg = img.copy() 


# get access to image pixels by loading the Image object firs 
® pixD = dmap.load() 


© 


6009 


pixS = sImg.load() 

# shift pixels horizontally based on depth map 

cols, rows = sImg.size 

for j in range(rows): 

for i in range(cols): 
xshift = pixD[i, j]/10 
xpos = i - tile.size[0] + xshift 
if xpos > © and xpos < cols: 
pixS[i, j] = pixS[xpos, j] 
# display the shifted image 
return sImg 


在 代行 ， 进 行 完整 性 检查 ， 确 保 深 度 图 和 图 像 








上 共有 相同 的 尺寸 。 在 信行 ， 如 果 用 户 没 有 提供 平 铺 


图 像 


‚KERLE THAR. ET, BE 


张 平 铺 好 的 图 像 ， 符 合 提 供 的 深度 图 的 大 小 。 然 


后 ， 在 人 @ 行 生成 这 张 平 铺 好 的 图 像 的 副本 。 


在 @ 行 ， 调 用 Image.load0) 方 法 ， 将 图 像 数 据 加 
载 到 内 存 中 。 该 方法 允许 用 形 如 [i，j] 的 三 维 数 组 来 
访问 图 像 像 素 。 在 @@ 行 ， 将 图 像 的 尺寸 保存 为 行 数 
和 列 数 ， 将 图 像 看 成 单个 像素 构成 的 网 格 。 


RUE I LTE FTG ARE 
UE » MAP AR PRAIA. SE 
做 到 这 一 点 ， 遍历 平 铺 图 像 Ah FE BE — TER. TE 
@ 行 ， 根 据 深度 图 pixD 中 的 相关 像素 ， 查 找 偏 移 的 
值 。 然 后 将 这 个 深度 值 除 以 10， 因 为 这 里 用 的 是 8 
位 深度 图 ， 这 意味 着 深度 的 范围 是 0 到 255。 如 果 除 
以 10， 得 到 的 深度 值 范围 古 0 到 25。 由 于 深度 图 输 
是 几 百 像素 ， 所 以 这 些 偏 移 值 很 
s 适 ( 党 试 改 变 除数 ， 看 看 它 如 何 有 影响 最 终 图 
BO. 


TZEA. BEA wA EA RS BRIENNE 
复 ， 由 公式 ai = ai + w 表 示 ， 其 中 的 ai 是 在 x 轴 下 标 ; 
处 的 给 定 像素 的 颜色 (因为 考虑 的 是 像素 行 ， 而 不 
是 列 ， 所 以 忽略 y 方 同 〉。 


要 创建 深 私 感 ， 束 要 让 间 阳 (或 重复 的 间距 》 
与 该 像素 的 深度 图 值 成 正比 。 这 样 在 最 终 的 三 维 并 
体 男 图 像 中 ， 每 个 像 系 和 它 前 一 次 〈 周 期 地 ) 出 现 






































相 比 ， 偏 移 了 delta i。 这 可 以 表示 为 bi=bi_w+s 


这 里 ，b; 表 示 最 后 的 三 维 立 体 画 图 像 中 ， 下 标 i 
处 给 定 像素 的 颜色 值 。 这 正 是 人行 所 做 的 事 。 深 度 
KEK (HE) 的 像素 没有 偏 移 ， 被 视 为 背景 。 

在 钨 行 ， 用 偏 移 的 值 蔡 换 每 个 像素 。 在 他 行 ， 
检查 确保 没有 试图 访问 不 在 图 像 中 的 像素 ， 因 为 偏 
移 ， 在 图 像 边缘 可 能 发 生 这 种 情况 。 
8.3.4 ”命令 行 选项 

现在 ， 我 们 来 看 看 该 程序 的 main() 方 法 ， 其 中 


提供 了 一 些 命令 行 选项 。 








# create a parser 


parser = argparse.ArgumentParser(description-"Autosterograms. 
# add expected arguments 
@ parser.add argument(' -- 
depth', dest-'dmFile', required-True) 
parser.add argument('-- 
tile', dest-'tileFile', required-False) 
parser.add argument('-- 
out', dest-'outFile', required-False) 
# parse args 
args - parser.parse args() 
# set the output file 
outFile - 'as.png' 
if args.outFile: 
outFile - args.outFile 
# set tile 
tileFile - False 
if args.tileFile: 
tileFile - Image.open(args.tileFile) 


在 @ 行 ， 像 以 前 的 项 目 一 样 ， 利 用 argparse 为 
程序 定义 了 一 些 命令 行 选项 。 一 个 必需 的 参数 是 深 
皮 图 文件 ， 两 个 可 选 的 参数 是 平 铺 图 像 文 件 名 和 输 
出 文件 名 。 如 果 示 指定 平 铺 图 像 ， 程 序 会 生成 随机 
圆圈 平 铺 图 像 。 如 果 未 指定 输出 文件 名 ， 则 三 维 立 
体 画 会 输出 到 as.png 文 件 。 





8.4 完整 代码 


下 面 是 完整 的 三 维 立 体 画 程序 。 也 可 以 从 
https://github.com/electronut/pp/blob/ 
master/autos/autos.py 下 载 这 上 段 代码 。 





import sys, random, argparse 
from PIL import Image, ImageDraw 


# create spacing/depth example 
def createSpacingDepthExample(): 


tiles = [Image.open('test/a.png'), Image.open('test/b.png'), 
Image.open('test/c.png')] 
img = Image.new('RGB', (600, 400), (0, ©, 0)) 
spacing - [10, 20, 40] 
for j, tile in enumerate(tiles): 
for i in range(8): 
img.paste(tile, (10 + i*(100 + j*10), 10 + j*100)) 
img.save('sdepth.png') 


# create an image filled with random circles 
def createRandomTile(dims): 

# create image 

img - Image.new('RGB', dims) 

draw - ImageDraw.Draw(img) 

# set the radius of a random circle to 1% of 

# width or height, whichever is smaller 

r = int(min(*dims)/100) 

# number of circles 

n = 1000 

# draw random circles 

for i in range(n): 

# = 

r makes sure that the circles stay inside and aren't cut off 


# at the edges of the image so that they'll look better when 
X, y - random.randint(0, dims[0]- 


r), random.randint(0, dims[1]-r) 


fill = (random.randint(®, 255), random.randint(®, 255), 
random.randint(0, 255)) 
draw.ellipse((x-r, y-r, x*r, y+r), fill) 
# return image 
return img 


# tile a graphics file to create an intermediate image of a s 
def createTiledImage(tile, dims): 

# create the new image 

img - Image.new('RGB', dims) 

W, H = dims 

w, h = tile.size 

# calculate the number of tiles needed 

cols - int(W/w) * 1 

rows = int(H/h) + 1 

# paste the tiles into the image 

for i in range(rows): 

for j in range(cols): 
img.paste(tile, (j*w, i*h)) 
# output the image 
return img 


# create a depth map for testing 

def createDepthMap(dims): 
dmap - Image.new('L', dims) 
dmap.paste(10, (200, 25, 300, 125)) 
dmap.paste(30, (200, 150, 300, 250)) 
dmap.paste(20, (200, 275, 300, 375)) 
return dmap 


# given a depth map image and an input image, 
4 create a new image with pixels shifted according to depth 
def createDepthShiftedImage(dmap, img): 

# size check 

assert dmap.size -- img.size 


# create shifted image 
sImg - img.copy() 
# get pixel access 
pixD - dmap.load() 
pixS - sImg.load() 
# shift pixels output based on depth map 
cols, rows = sImg.size 
for j in range(rows): 

for i in range(cols): 

xshift = pixD[i, j]/10 


xpos - i - 140 + xshift 
if xpos > 0 and xpos < cols: 
pixS[i, j] = pixS[xpos, j] 
# return shifted image 
return sImg 


# given a depth map (image) and an input image, 
# create a new image with pixels shifted according to depth 
def createAutostereogram(dmap, tile): 
# convert the depth map to a single channel if needed 
if dmap.mode is not 'L': 
dmap - dmap.convert('L') 


# if no image is specified for a tile, create a random circle 
if not tile: 
tile - createRandomTile((100, 100)) 
# create an image by tiling 
img - createTiledImage(tile, dmap.size) 
# create a shifted image using depth map values 
sImg - img.copy() 


# get access to image pixels by loading the Image object firs 
pixD - dmap.load() 
pixS - sImg.load() 
# shift pixels horizontally based on depth map 
cols, rows = sImg.size 
for j in range(rows): 
for i in range(cols): 

xshift = pixD[i, j]/10 

xpos = i - tile.size[0] + xshift 

if xpos > 0 and xpos < cols: 

pixS[i, j] = pixS[xpos, j] 

# return shifted image 
return sImg 


# main() function 

def main(): 
# use sys.argv if needed 
print('creating autostereogram...') 
4 create parser 


parser = argparse.ArgumentParser(description="Autosterograns. 
# add expected arguments 
parser.add argument('-- 
depth', dest-'dmFile', required-True) 
parser.add argument('-- 
tile', dest-'tileFile', required-False) 
parser.add argument('-- 


out', dest-'outFile', required-False) 
# parse args 
args - parser.parse args() 
# set the output file 
outFile - 'as.png' 
if args.outFile: 
outFile - args.outFile 
# set tile 
tileFile - False 
if args.tileFile: 
tileFile - Image.open(args.tileFile) 
# open depth map 
dmImg - Image.open(args.dmFile) 
4 create stereogram 
asImg - createAutostereogram(dmImg, tileFile) 
# write output 
asImg.save(outFile) 


# call main 
if _name__ == ' main ': 
main() 


ME, KAIHFET (stool-depth.png) 的 深度 
图 运行 该 程序 。 


$ python3 autos.py --depth data/stool-depth.png 
8-67: aN f VRBES, XA EZ Y AE Be 


三 维 立 体 男 。 因 为 没有 为 平 铺 提 供 图 像 ， 这 张 三 维 
立体 画 使 用 了 随机 生成 的 平 铺 图 像 。 











图 8-6  autos.py3& 11 zs f/l 


现在 ， 让 我 们 给 定 一 个 平 铺 图 像 作 为 输入 。 像 
前 面 一样 使 用 stool-depth.png 深 度 图 ， 但 这 一 次 ， 提 


ft E escher-tile.jpg2ME KFR EL 


$ python3 autos.py --depth data/stool-depth.png - 
tile data/escher-tile.jpg 


图 8-7 展 示 了 输出 o 






ad N 


图 8-7 使 用 平 铺 图 像 的 autos.py 运 行 示例 


8.6 ”小 结 


在 本 项 目 中 ， 我 们 学 习 了 如 何 创 建 三 维 立 体 
画 。 给 定 深 度 图 的 图 像 ， 我 们 现在 可 以 创建 随机 点 
的 三 维 立 体 夯 ， 或 用 提供 的 图 像 来 平 铺 。 





8.7 IR 


这 里 有 一 些 方法 ， 可 以 进一步 探索 三 维 立 体 
H. 


1. 编程 创建 类 似 图 8-2 的 图 像 ， 演 示 图 像 中 线 
性 间距 的 变化 如 何 制 造 深 度 的 约 觉 〈 提 示 : 利用 图 
像 平 铺 和 Image.paste(0) 方 法 ) 。 


2， 为 程序 添加 一 个 命令 行 选项 ， 指 定 应 用 于 
深度 图 值 的 比例 《回忆 一 下 ， 代 码 中 深度 图 值 除 以 
10) 。 变 更 如 何 影响 到 三 维 立 体 画 ? 


3. 学 习 用 SketchUp 这 样 的 工具 ， 创 建 自 己 的 
三 维 模型 深度 图 (http://sketchup. com/) ， 或 在 线 
访问 许多 现成 的 SketchUp 模 型 。 利 用 SketchUp 的 
Fog 选 项 来 创建 你 的 深度 图 。 如 需 帮 助 ， 看 看 这 个 
YouTube 视 频 : https://www.youtube.com/watch?v= 
fDzNJYi6Bok/. 





[1] http://colorstereo.com/texts_.txt/practice.htm 
[2] Bet Pe e X fn 
[3]  http://calculus-geometry.hubpages.com/hub/Free- 


M-C-Escher-Tessellation-Background-Patterns-Tiling- 
Lizard-Background/ 


第 四 部 分 “ 走 进 三 维 


“在 一 维 中 ， 移 动 一 个 点 难道 不 是 产生 了 有 两 个 端 
点 的 线段 ? 


在 两 维 中 ， 移 动 一 段 线 难道 不 是 产生 了 有 四 个 端 挟 
的 正方 形 ? 


在 三 维 中 ， 移 动 一 个 正方 形 难道 不 是 产生 了 《我 的 
眼睛 没有 看 见 ) 


那 种 神奇 的 造物 ， 立 方 体 ， 有 八 个 端 氮 ? C 


— —Edwin A. Abbott, Flatland: A Romance of Many 
Dimensions 








本 项 目 将 创建 一 个 简单 的 程序 ， 利 用 OpenGL 
和 GLFW 来 显示 纹理 贴图 的 正方 形 。OpenGL 为 图 
形 处 理 单 元 GPU) 增加 了 一 个 软件 接口 ， 而 
GLFW 是 一 个 窗口 工具 包 。 我 们 还 将 学 习 如 何 使 用 
类 似 C 语 言 的 OpenGL 着 色 语 言 (GLSL) 来 编写 着 
色 右 ， 即 在 GPU 上 执行 的 代码 。 着 色 器 为 OpenGL 
中 的 计算 带 来 巨大 的 灵活 性 。 我 会 展示 如 何 用 
GLSL 厦 色 器 来 变换 几何 图 形 并 上 色 ， 创 建 一 个 旋 
转 的 、 市 纹理 的 多 边 形 (如 图 9-1 所 示 )。 


GPU 经 过 优化 ， 以 并 行 的 方式 对 大 量 数据 反复 
地 执行 相同 的 操作 ， 这 让 它们 在 做 这 样 的 工作 时 ， 








比 中 央 处 理 单 元 (CPU) 快 得 多 。 除 了 演 染 计算 机 
图 形 ， 它 们 也 用 于 通用 计算 ， 现 在 有 一 些 专门 的 语 
言 让 你 用 GPU 硬件 完成 这 样 的 工作 。 本 项 目 将 利用 
GPU, OpenGL4AUE Ei. 


Python 是 一 种 极 好 的 “胶水 ”语言 。 对 于 其 他 语 
言 《 如 C 语 言 ) 编写 的 库 ， 有 大 量 的 Python 绑 定 ， 
让 你 在 Python 中 使 用 它们 。 本 章 和 第 10 章 、 第 11 
章 ， 将 使 用 PyOpenGL， 即 OpenGEL 的 Python 绑 定 ， 
来 创建 计算 机 图 形 。 


OpenGL 征 一 个 “状态 机 ”， 有 点 像 一 个 电器 开 
关 ， 有 两 种 状态 : 开 和 关 。 如 果 从 一 种 状态 切换 到 
男 一 种 ， 开 关 束 你 持 在 这 种 新 状态 。 然 而 ， 
OpenGL 比 简单 的 电器 开关 更 复杂 ， 它 更 像 一 个 交 
换 机 ， 有 许多 开关 和 表盘 。 一 旦 更 改 特定 设置 的 状 
态 ， 它 就 保持 为 和 天， 直到 你 打开 。 如 果 一 个 
OpenGL 调 用 绑 定 到 茶 个 对 象 上 了 ， 那 随后 的 相关 
调用 都 会 发 送 给 这 个 对 象 ， 直 到 解除 绑 定 。 

















eoo simpleglfw 





图 9-1 ”本章 项 目 生 成 的 最 终 图 像 一 个 旋转 的 多 边 形 ， 它 带 有 
一 个 星 形 图 采 。 利 用 看 色 器 ， 这 个 方形 的 多 边 形 边 界 被 县 裁 成 
个 黑色 圆圈 


下 面 是 本 项 目 引 入 的 一 些 概 念 : 





。 使 用 针对 OpenGL 的 GLFW 窗 口 库 ; 
。 使 用 GLSL 编 写 顶 点 和 片段 着 色 器 ; 
。 进 行 纹理 贴图 ; 
。 使 用 三 维 变换 。 


首先 ， 我 们 来 看 看 OpenGEL 的 工作 原理 。 


9.1 老式 OpenGL 





在 大 多 数 计算 机 图 形 系统 中 ， 绘 图 的 方式 是 将 
一 些 顶 点 发 送 给 处 理 管线 ， 管 线 由 一 系列 功能 模块 
互相 连接 而 成 。 最 近 ，OpenGL 应 用 编程 接口 
CAPT) 从 固定 功能 的 图 形 管 线 转 为 可 编程 的 网 形 
管线 。 我 们 将 专注 于 现代 的 OpenGL， 但 因为 在 网 
络 上 会 看 到 许多 “老式 ”OpenGL 的 例子 ， 我 会 让 你 
e 以 更 好 地 感受 所 发 生 的 
ARM 0 


例如 ， 下 面 这 个 简单 的 老式 OpenGL 程 序 在 屏 
幕 上 绘制 一 个 黄色 的 矩形 。 








import sys 
from OpenGL.GLUT import * 
from OpenGL.GL import * 


def display(): 
glClear (GL COLOR BUFFER BIT|GL DEPTH BUFFER BIT) 
glColor3f (1.0, 1.0, 0.0) 
glBegin(GL QUADS) 
glVertex3f (-0.5, -0.5, 0.0) 
glVertex3f (0.5, -0.5, 0.0) 
glVertex3f (0.5, 0.5, 0.0) 
glVertex3f (-0.5, 0.5, 0.0) 
glEnd() 
glFlush(); 


glutInit(sys.argv) 
glutInitDisplayMode(GLUT. SINGLE |GLUT. RGB) 
glutInitwindowSize(400, 400) 


glutCreatewindow("oldgl") 
glutDisplayFunc(display) 
glutMainLoop() 
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图 9-2 ”简单 的 老式 OpenGL 程 序 的 输出 


使 用 老式 OpenGL， 要 为 三 维 图 元 (在 这 个 例 
子 中 ， 是 一 个 GL_LQUAD， 即 窍 形 ) 指定 各 个 顶 
点 ， 但 随后 每 个 顶点 需要 被 分 别 发 送 到 GPU， 这 是 
低 效 的 方式 。 这 种 老式 编程 模式 伸缩 性 不 好 ， 如 果 
几何 图 形变 得 复杂 ， 程 序 就 会 很 慢 。 对 于 屏幕 上 的 
顶点 和 像素 如 何 变换 ， 它 只 提供 有 限 的 控制 《在 本 


项 目 中 可 以 看 到 ， 用 新 的 可 编程 管线 的 范式 ， 可 以 
FEAR IR LE BR AI) 。 


9.2 ”现代 OpenGL: ZEITEN 


为 了 让 你 感受 现代 OpenGL 如 何在 较 高 层面 上 
工作 ， 让 我 们 利用 一 系列 的 操作 ， 即 通常 所 谓 
的 “三 维 图 形 管 线 *"， 在 屏 大 上 男 一 个 三 角形 。 图 9-3 
给 出 了 OpenGL 三 维 图 形 管 线 的 简化 表示 。 











三 维 几何 图 形 定义 (VBO 等 ) 















hives — WARRE (深度 测试 、 混 和 等 ) | 一 > WA 








图 9-3 (fai (KA) OpenGL 图 形 管线 


在 第 一 步 ， 通 过 定义 在 三 维 空间 中 的 三 角形 的 
顶点 ， 并 指定 每 个 项 点 相关 联 的 斋 色 ， 我 们 定义 了 
三 维 几 何 图 形 。 接 下 来 ， 变 换 这 些 顶 点 : 第 一 次 变 
换 将 这 些 顶 点 放 在 三 维 空间 中 ， 第 二 次 变换 将 三 维 
坐标 投影 到 二 维 空间 。 根 据 照 明 等 因 系 ， 对 应 顶点 























的 闫 色 值 也 在 这 一 步 中 计算 ， 这 在 代码 中 通 第 称 
AUR AS a” e 


接着 ， 将 几何 图 形 “ 光 栅 化 ”〈 从 几何 物体 转换 
为 像 系 ) ， 针 对 每 个 像 系 ， 执 行 妨 一 个 名 为 “片段 
着 色 器 ”的 代码 块 。 正 如 顶点 着 色 器 作用 于 三 维 顶 
Ro ABRE BIMF TI E ZERK 


最 后 ， 像 素 经 过 一 系列 帧 缓冲 区 操作 ， 其 中 ， 
它 经 过 “深度 缓冲 区 检验 ”( 检 查 一 个 片段 是 否 谈 挡 
另 一 个 ) 、“ 混 合 ”( 用 透明 度 混合 两 个 片段 ) 以 及 
其 他 操作 ， 其 当前 的 颜色 与 帧 缓冲 区 中 该 位 置 已 有 
的 颜色 结合 。 这 些 变化 最 终 体现 在 最 后 的 帧 缓冲 区 
上 ， 通 常 显示 在 屏幕 上 。 


9.2.1 ”几何 图 元 


因为 OpenGL 是 一 个 压 层 图 形 库 ， 你 不 能 要 求 
它 直 接 画 出 一 个 立方 体 或 球体 ， 但 建立 在 它 之 上 的 
库 可 以 完成 这 样 的 任务 。OpenGL 只 理解 底层 的 几 
何 图 元 ， 如 点 、 线 和 三 角形 。 


现代 OpenGL 只 文 持 GL_POINTS、 
GL LINES. GL LINE STRIP, GL LINE LOOP, 
GL_TRIANGLES, GL TRIANGLE STRIPZI 
GL_TRIANGLE_FAN 等 图 元 类 型 。 图 9-4 展 示 了 图 
元 的 顶点 是 如 何 组 织 的 。 显 示 的 每 个 顶点 是 一 个 三 




















维 坐 标 ， 形 如 (x, y, 7)。 





Vo 
i GL_POINTS 
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图 9-4 ”OpenGL 的 图 元 


要 在 OpenGL 中 绘制 球体 ， 首 先 要 在 数学 上 定 
义 球体 的 几何 图 形 ， 并 计算 其 三 维 顶 点 。 然 后 ， 将 
这 些 顶 点 组 合 为 基本 的 几何 图 元 。 例 如 ， 可 以 将 每 
组 三 个 顶点 组 成 一 个 三 角形 。 然 后 ， 可 以 用 


3 vy 


OpenGL 演 染 这 些 顶 点 。 
922 ”三维 变换 


不 学 三 维 变 换 ， 束 不 展 计 算 机 图 形 学 。 三 维 变 
换 的 概念 都 很 们 蛙 易 履 。 你 有 一 个 物体 ， 能 对 它 做 
怎么 呢 ? 可 以 移动 、 拉 伸 《 或 挤 压 ) 或 旋转 。 也 可 
以 做 其 他 事情 ， 但 这 3 个 任务 是 物体 最 第 见 的 操作 
或 变换 : 和 平移、 缩放 和 旋转 。 除 了 这 些 冲 用 的 变 
换 ， 还 得 用 透视 投影 将 三 维 物体 映射 到 屏幕 的 二 维 
平面 。 这 些 变换 都 应 用 于 你 要 变换 的 物体 上 。 


虽然 你 可 能 熟悉 (x, y, 20 形式 的 三 维 坐 标 ， 
但 在 三 维 计算 机 图 形 中 使 用 Cx, y, z w) 形式 的 坐 
标 ， 即 齐 次 坐标 (“这些 坐标 来 自 数 学 的 一 个 分 支 ， 
即 射 影 几 何 ， 这 超出 了 本 书 的 范围 ) 。 


其 次 坐标 允许 用 4x4 的 矩阵 来 表示 这 些 和 常见 的 
三 维 变换 。 但 对 于 这 些 OpenGL 项 目 ， 你 只 要 知道 
齐 次 坐标 Cx, y, Zz, w) 相当 于 三 维 坐标 (Xx/w，y/w， 
z/w, 1.0). =4EAY FR (1.0, 2.0, 3.0) 可 以 用 齐 次 坐标 
表示 为 (1.0,2.0, 3.0, 1.0) 。 











下 面 是 用 变换 矩阵 进行 三 维 变换 的 一 个 例子 。 
看 看 矩阵 乘法 如 何 将 一 个 点 (Xx, y, z，1.0) 变 换 为 (x + 
tx, y + ty, z * tz, 1.0). 


0 1 0 J " 

在 OpenGL 中 经 常会 过 到 两 个 术语 : 模型 视图 
变换 和 投影 变换 。 随 着 现代 OpenGL 中 可 定制 的 着 
色 器 的 问世 ， 模 型 视图 和 投影 都 只 是 普通 的 变换 。 
从 历史 上 看 ， 在 老式 OpenGL 版 本 中 ， 模 型 视图 变 
换 用 于 三 维 模 型 ， 将 它 置 于 空间 中 ， 而 投影 变换 将 
三 维 坐 标 映射 到 二 维 平面 ， 用 于 显示 ， 你 会 马上 看 
到 。 模 型 视图 变换 是 用 户 定 义 的 变换 ， 让 你 放置 三 
维 物 体 ， 投 影 变 换 是 三 维 映 射 到 二 维 的 变换 。 


两 种 最 常用 的 三 维 图 形 投影 变换 十 “ 正 投 
影 ? 和 “透视 投影 ”， 但 这 里 只 会 用 到 透视 投影 ， 这 
征 由 “视角 ”( 眼 睛 能 看 到 的 范围 ) 、“ 近 裁剪 平 
面 ”〈 最 接近 眼睛 的 平面 ) 、“ 远 裁 甬 平面 ”《〈 离 眼 
青 最 远 的 平面 〉 和 “纵横 比 ”( 近 平面 的 宽度 与 高 度 
之 比 〉 来 确定 的 。 这 些 参数 共同 构成 了 一 个 摄像 机 
模型 ， 决 定 了 三 维 形状 如 何 映 冉 到 二 维 屏 莫 上 ， 如 
图 9-5 所 示 。 图 中 的 截 尖 金字 塔 是 “ 视 景 体 *。“ 了 眼 
晴 ” 是 摄像 机 的 三 维 位 置 (对 于 正 投影 ， 眼 睛 将 在 
无 穷 远 处 ， 金 字 塔 将 变 成 长 方 体 )。 
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295 ”透视 投影 摄像 机 模型 


透视 投影 完成 后 ， 在 光栅 扫 摘 之 前 ， 疼 元 将 会 
被 远近 裁剪 平面 切割 《或 剔 除 ) ， 如 图 9-5 所 示 。 
远近 裁 琶 平面 的 选择 ， 要 让 希望 出 现在 屏幕 上 的 三 
维 物体 位 于 视 景 体 之 和 内， 人 否则， 它们 将 被 裁 甬 。 


9.2.3 ”着 色 器 





你 已 见 过 着 色 恬 如 何 融 入 现代 OpenGL 的 可 编 
程 图 形 管线 了 。 现 在 ， 我 们 来 看 看 一 对 简单 的 顶点 
和 片段 着 色 右 ， 了 解 GLSL 的 工作 原理 。 


THUR a Gs 
Fi 71 fil 5 ER a a A: 


@ #version 330 core 
© in vec3 avert; 


® uniform mat4 uMVMatrix; 
€ uniform mat4 uPMatrix; 


® out vec4 vCol; 


void main() { 
// apply transformations 
Q gl Position = uPMatrix * uMVMatrix * vec4(aVert, 1.0); 
// set color 
@ vCol = vec4(1.0, 0.0, 0.0, 1.0); 
J 


在 @ 行 ， 将 着 色 器 中 使 用 的 GLSL 版 本 设置 为 
3.3。 然 后 ， 用 关键 字 h 为 项 点 着 色 器 定义 一 个 输 
入 ， 名 为 aVert， 类 型 为 vec3 (三 维 向 量 ) 0. #9 
行 和 人 @ 行 ， 定义 两 个 类 型 为 mat4〈(4x4 的 矩阵 ) 的 
变量 ， 分 别 对 应 于 模型 视图 和 投影 第 阵 。 这 些 变 量 
uniform RRHH, (ETT IW EE tus. I 28 TDI 
点 进行 指定 的 演 染 调用 时 ， 它 们 不 会 改变 。 在 人 @ 行 
用 out 定 义 了 顶点 着 色 器 的 输出 ， 其 类 型 为 











vec4(4D 问 量 ， 保 存 红 、 绿 、 蓝 和 alpha 通 道 ) ， 是 
— AN EAR E, 


接 下 来 是 main() 函 数 ， 这 是 顶点 着 色 器 程序 开 
始 的 地 方 。 在 人 @ 行 计算 出 g]_Position 的 值 ， 方 法 是 
利用 传 入 的 uniform 和 矩阵 来 变换 输入 的 aVert。GLSL 
变量 gl_Position 用 于 保存 变换 后 的 顶点 。 在 @@ 行 ， 
34 T ERE ESL 的 箱 出 颜色 设 为 红色 ， 没有 透明 度 ， 
值 为 (1，0，0，1) 。 管 线 中 的 下 一 个 着 色 堪 用 它 
作为 输入 。 


H BRA Bias 
HEREIN Fr BOE C a 








@ #version 330 core 

€ in vec4 vCol; 

® out vec4 fragColor; 
void main() ( 


// use vertex color 
@ fragColor = vCol; 
} 


在 @ 行 设置 着 色 器 的 GLSL 版 本 后 ， 人 @ 行 设置 
vCol 作 为 厂 段 着色 器 的 输入 。 这 个 变量 VCol 曾 被 设 
为 项 点 着 色 器 输出 (回忆 一 下 ， 顶 点 着 色 器 针对 三 
维 场景 中 的 每 个 顶点 执行 ， 而 片段 看 色 器 针对 屏幕 


上 的 每 个 像 系 执行 )。 


在 光栅 化 期 间 (发 生 在 顶点 着 色 器 和 片段 着 色 
LR) ，OpenGL 将 变换 后 的 顶点 转换 为 像素 ， 
通过 在 顶点 两 色 之 间 插 值 ， 计 算 顶 点 之 间 像 素 的 两 
色 。 


在 全 行 ， 定 义 了 输出 颜色 变量 fragColor， 在 他 
行 ， 插 值 计 算出 的 闫 色 被 设置 为 输出 。 默 认 情 况 
下 ， 也 是 在 大 多 数 情 况 下 ， 厂 段 厦 色 器 的 预期 输出 
是 屏幕 ， 设 置 的 凑 色 最 终 会 出 现在 屏幕 上 【除非 受 
到 一 些 操 作 的 影响 ， 诸 如 发 生 在 图 形 管线 中 最 后 阶 
段 的 深度 测试 ) 。 


要 让 GPU 执 行 厦 色 右 代码 ， 需 要 编译 和 链接 ， 
成 为 硬件 理解 的 指令 。OpenGL 提 供 了 一 些 方法 来 
做 到 这 一 点 ， 它 报告 详细 的 编译 和 链接 错误 ， 这 有 
助 于 开发 着 色 髓 代码 。 

编译 过 程 也 会 为 着 色 器 中 声明 的 变量 产生 一 张 
位 置 ( 索 引 ) 表 ， 用 它 可 以 连接 Python 代 人 码 中 的 变 
量 和 着色 器 中 的 变量 。 

9.2.4 MARK 
顶点 缓冲 区 是 OpenGL 着 色 器 使 用 的 一 种 重要 


机 制 。 现 代 图 形 硬件 和 OpenGL 则 在 处 理 大 量 的 三 
维 几何 图 形 。 因 此 ，OpenGL 内 建 了 一 些 机 制 ， 帮 























助 将 数据 从 程序 传输 到 GPU 。 程 序 中 绘制 三 维 几 何 
图 形 的 典型 计划 将 执行 以 下 操作 : 


1. 为 三 维 几 何 图 形 的 每 个 顶点， 定义 坐标 、 
颜色 和 其 他 属性 的 数组 ; 


2. 创建 一 个 顶点 数组 对 象 CVAO) ， 并 绑 定 
到 它 ; 


3. 为 每 个 属性 ， 创 建 顶 点 缓冲 区 对 象 
(VBOO ， 针 对 每 个 顶点 来 定义 ; 


4. 绑 定 到 该 VBO， 并 设置 缓冲 区 数据 使 用 预 
先 定义 的 数组 ; 


5， 指 定 着 色 器 中 使 用 的 顶点 属性 的 数据 和 位 
置 








6. 启用 顶点 的 各 种 属性 ; 
7. THAN. 


用 顶点 来 定义 三 维 几何 图 形 之 后 ， 可 以 创建 并 
绑 定 到 一 个 顶点 数组 对 象 。 VAO 是 一 种 方便 的 方 
却 ， 将 几何 图 形 分 组 坐标 、 颜 色 等 多 个 数组 。 然 
后 ， 针 对 每 个 顶点 的 每 个 属性 ， 可 以 创建 一 个 顶点 
缓冲 区 对 象 ， 并 将 三 维 数据 设置 给 它 。VBO 将 顶 操 
数据 保存 在 GPU 和 内 存 中 。 现 在 ， 剩 下 的 殉 是 连接 组 
冲 区 数据 ， 以 便 从 看 色 虱 中 访问 它 。 通 过 一 些 调 











用 ， 毛 们 使 用 春色 器 中 用 到 的 变量 的 位 置 ， 来 实现 


INN 


925 ”纹理 贴图 


接 下 来 ， 看 看 纹理 贴图 : 本 章 将 使 用 的 一 种 重 
要 计算 机 图 形 技 术 。“ 纹 理 贴图 * 利 用 三 维 物 体 上 的 
二 维 图 片 ， 让 场景 有 通 真 的 感觉 〈 束 像 演 出 的 舞台 
背景 ) 。 纹 理 通 党 从 一 个 图 像 文件 中 读 取 ， 被 拉 伸 
FP te N) MR EAR CEB 73[0,1]) 
映射 到 多 边 形 的 三 维 坐 标 上 。 例 如 ， 图 9-6 展 示 一 
幅 图 像 履 新 在 立方 体 的 一 个 面 上 我 用 
GL_TRIANGLE_STRIP 图 元 来 绘制 立方 体 各 面 ， 顶 
点 的 顺序 由 面 上 的 线 来 表示 ) 。 


在 图 9-6 中 ， 纹 理 的 (0，0) 角 映 射 到 立方 体 
表面 的 左下 顶点 。 类 似 地 ， 可 以 看 到 纹理 的 其 他 角 
如 何 上 映射， 最 终 的 效果 就 是 纹理 被 < 粘贴 ”到 这 个 并 
方 体 表面 。 立 方 体 表 面 本 里 的 几何 图 形 被 定义 为 一 
个 三 角形 带 ， 这 些 顶 点 曲折 排列 ， 从 底 到 左上 ， 再 
从 底 到 在 上。 纹理 是 非常 强大 和 有 灵活 的 计算 机 图 形 
工具 ， 你 会 在 第 11 章 中 看 到 。 























I eg 


图 9-6 ”纹理 贴图 


9.2.6 ”到 示 OpenGL 


han 屏幕 上 绘制 东 
西 。 保 存 所 有 OpenGL 状 态 信息 的 实体 叫 
做 “OpenGL 上 和 下文 ?>。 上 下 文具 有 一 个 可 视 的 、 窗 
口 状 的 区 域 ，OpenGEL 的 绘制 在 其 中 进行 ， 每 个 进 
程 或 应 用 程序 的 每 次 运行 可 以 有 多 个 上 下 文 ， 但 每 
个 线程 在 同一 时 刻 只 能 有 一 个 当前 上 下 文 〈 好 在 ， 
窗口 工具 包 将 负责 大 多 数 的 上 下 文 处 理 ) 。 


要 让 OpenGL 的 输出 出 现在 屏幕 的 窗口 中 ， 惑 
需要 操作 系统 的 帮助 。 对 于 这 些 项 目 ， 你 将 使 用 











GLFW， 它 是 一 个 轻 量 级 的 跨 平 台 C 库 ， 可 以 让 你 
创建 和 管理 OpenGL 上 上 下文， 在 窗口 中 显示 三 维 图 
形 ， 并 处 理 用 户 的 输入 ， 如 鼠标 点 击 和 按键 。《〈 附 
录 A 介 绍 了 这 个 库 的 安装 细节 。) 


因为 要 用 Python 写 代码 ， 而 不 是 C 语 言 ， 所 以 
还 要 使 用 GLFW 的 Python 绑 定 〈glfw.py， 在 本 书 代 
码 库 的 common 目 录 中 可 以 找到 ) ， 它 可 以 让 你 用 
Python 访问 GLFW 的 所 有 功能 。 








9.3 ”所 需 模 块 


我 们 将 使 用 PyOpenGL (一 个 流行 的 OpenGL 
Python 绑 定 ) 来 泻 染 ， 并 用 numpy 数 组 来 表示 三 维 
坐标 和 变换 矩阵 。 
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让 我 们 用 OpenGL 创 建 一 个 人 简单 的 Python 应 用 
程序 。 要 和 奏 看 完整 的 项 目 代 码 ， 请 直接 跳 到 9.5 节 。 


9.4.4 JÆ OpenGL 窗口 

第 一 件 事 就 是 设置 GLFW， 以 便 有 一 个 
OpenGL 和 窗口 显示 洽 染 的 结果 。 我 创建 了 一 个 
RenderWindow 类 来 做 这 件 事 。 

下 面 是 这 个 类 的 初始 化 代码: 





class RenderWindow: 
"""GLFW Rendering window class""" 
def _ init (self): 


# save current working directory 
cwd = os.getcwd() 


# initialize glfw 
e glfw.glfwInit() 


# restore cwd 
os.chdir(cwd) 


# version hints 
e 
glfw.glfwwindowHint(glfw.GLFW CONTEXT VERSION MAJOR, 3) 
glfw.glfwwindowHint(glfw.GLFW CONTEXT VERSION MINOR, 3) 


glfw.glfwwindowHint(glfw.GLFW OPENGL FORWARD COMPAT, GL TRUE) 
glfw.glfwwindowHint(glfw.GLFW OPENGL PROFILE, 


glfw.GLFW OPENGL CORE PROFILE) 
# make a window 
self.width, self.height - 640, 480 
self.aspect - self.width/float(self.height) 


self.win - glfw.glfwCreatewindow(self.width, self.height, 
b'simpleglfw') 


# make the context current 
@ glfw.glfwMakeContextCurrent(self.win) 


在 @ 行 初始 化 GLFW 库 。 然 后 ， 从 全 行 开始 ， 
将 OpenGL 版 本 设置 为 OpenGL ”3.3 的 核心 模式 。 在 
全 行 ， 创 建 尺 寸 为 640x480 的 、 支 持 OpenGL 的 窗 
口 。 最 后 ， 在 全 行 ， 让 它 成 为 当前 上 下 文 ， 然 后 就 
可 以 进行 QOpenGL 调 用 了 。 


接 下 来 ， 进 行 一 些 初始 化 调用 。 





# initialize GL 

glViewport(0, 0, self.width, self.height) 
glEnable(GL_DEPTH_TEST) 

glClearColor (0.5, 0.5, 0.5, 1.0) 


ooo 








在 @ 行 ， 设 置 视 口 或 屏幕 尺寸 (宽度 和 高 
HE) ，OpenGL 将 在 其 中 演 染 三 维 场景 。 在 信行 ， 
用 GL_DEPTH_TEST 打 开 深度 测试 。 在 个 行 ， 将 演 
Ze REC] ys HA glClearQ iY WG 3x DA £6 e EL 7350 96 HY 
灰色 ， Alpha 设 置 为 1.0 (Alpha 是 像素 透明 度 的 度 
量 ) 。 





9.4.2 设置 回调 


下 一 步 ， 在 GLFW 窗 口中 为 用 户 接 口 事件 注册 
一 些 事 件 回 调 ， 这 样 就 可 以 啊 应 鼠标 点 击 和 按键 。 


# set window callbacks 
glfw.glfwSetMouseButtonCallback(self.win, self.onMouseButton) 


glfw.glfwSetKeyCallback(self.win, self.onKeyboard) 
glfw.glfwSetWindowSizeCallback(self.win, self.onSize) 


这 段 代 码 分 别 设置 了 鼠标 按钮 、 键 盘 按 键 和 窗 
口 大 小 调整 的 回调 。 每 当 一 个 事件 发 生 时 ， 注 册 为 
回调 的 函数 束 执 行 。 


键盘 回调 
来 看 看 键盘 回调 : 





def onKeyboard(self, win, key, scancode, action, mods): 
Zprint 'keyboard: ', win, key, scancode, action, mods 

e if action -- glfw.GLFW PRESS: 

4 ESC to quit 

if key -- glfw.GLFW KEY ESCAPE: 
(2) self.exitNow = True 

else: 

# toggle cut 


self.scene.showCircle = not self.scene.showCircle 


每 次 键盘 事件 发 生 时 ，onKeyboard0O) 回 调 就 被 


调用 。 该 函数 的 参数 被 填充 了 有 用 的 信息 ， 如 发 生 
事件 的 类 型 〈 例 如 key-up 或 key-down) ， 以 及 按 了 
哪个 键 。 代 码 glfw.GLFW_PRESS 是 说 只 查找 
keydown (EXPRESS) 事件 @。 在 信行 ， 如 果 按 下 
ESC 键 ， 束 设置 退出 标志 。 如 果 按 下 其 他 任何 键 ， 
翻转 showCircle 布 尔 值 ， 它 将 传 入 片段 着 色 器 他。 


调整 窗口 大 小 事件 
下 面 是 调整 窗口 大 小 事件 的 处 理 : 





def onSize(self, win, width, height): 
#print 'onsize: ', win, width, height 
self.width - width 
self.height - height 
self.aspect - width/float(height) 
e glViewport(0, ©, self.width, self.height) 





每 次 窗口 大 小 变化 时 ， 调 用 glViewport() 重 置 
图 形 尺寸 ， 确 保 三 维 场景 正确 绘制 在 屏幕 上 人 @。 同 
时 将 尺寸 保存 在 width 和 height 中 ， 改 变 后 的 窗口 的 
纵横 比 保存 在 aspect 中 。 


主 循环 
现在 来 到 程序 的 主 循 坏 “GLFW 不 提供 默认 的 
程序 循环 ) 。 


def run(self): 
# initializer timer 


(1) glfw.glfwSetTime(0) 
t = 0.0 


while not glfw.glfwWindowShouldClose(self.win) and not self.e 
# update every x seconds 
e currT = glfw.glfwGetTime() 
if currT - t > 0.1: 
# update time 
t - currT 
# clear 


glClear(GL COLOR BUFFER BIT | GL DEPTH BUFFER BIT) 
# build projection matrix 
® 
pMatrix = glutils.perspective(45.0, self.aspect, 0.1, 100.0) 


® 

mvMatrix = glutils.lookAt([0.0, 0.0, -2.0], [0.0, 0.0, 0.0], 
[0.0, 1.0, 0.0]) 

# render 

self.scene.render(pMatrix, mvMatrix) 

# step 

self.scene.step() 


glfw.glfwSwapBuffers(self.win) 
# poll for and process events 
glfw.glfwPollEvents() 


© 000 


# end 
glfw.glfwTerminate() 


在 主 循环 中 ，glfw.glfwSetTime0 将 GLFW 计 时 


器 重 置 为 0 @ 行 。 你 将 用 这 个 计时 器 定期 重新 绘制 
图 形 。while 循 环 从 人 行 开 始 ， 只 有 在 窗口 关闭 或 
exitNow 设 为 True 时 退出 。 循 环 退 出 时 ， 
glfw.glfwTerminateO 补 调用， 完全 关闭 GLFW。 





在 循环 中 ，glfw.glftwGetTime() 取 得 当前 计时 帮 


的 值 @， 用 它 来 计算 自 上 次 绘图 以 来 的 时 间 。 这 里 


设置 期 望 的 间隔 《在 这 个 例子 中 是 0.1 秒 ， 即 100 军 
秒 ) ， 从 而 可 以 调整 帧 演 染 的 速度 。 


接着 ， 在 人 @ 行 ，glClear() 清 除了 深度 和 颜色 绥 
冲 区 ， 用 设置 的 背景 颜色 答 换 它们 ， 准 备 男 下 一 
帧 。 在 加 行 ， 用 glutils.py〈 下 一 节 将 详细 探讨 ) 中 
定义 的 perspective0) 方 法 ， 计 算 投 影 矩 阵 。 这 里 ， 要 
求 45 上 度 视 场 ， 近 / 远 裁 前 平面 的 距离 为 0.1100.0。 然 
后 ， 利 用 glutils.py 中 定义 的 lookAt(0) 方 法 ， 在 @@ 行 设 
置 模型 视图 矩阵 。 将 眼睛 位 置 设置 在 (0， 

0，-2) ， 用 一 个 “同上 ”矢量 (0，1, 0) 看 同 原 点 (0，0， 
0)。 然 后 ， 在 @ 行 调用 scene 对 象 上 的 render() 方 法 ， 
传 入 这 些 算 阵 ， 在 全 行 调用 scene.step()， 以 便 更 新 
所 需 的 时 间 步 长 变量 。 在 四 行 ， 调 用 
glfwSwapBuffers()， 交 换 前 后 绥 冲 区 ， 从 而 显示 更 
新 的 三 维 图 像 。 多 行 的 glfwPollEvents0O) 调 用 检查 所 
有 UI 事件 ， 将 控制 返回 给 while 循 环 。 


双 绥 冲 











双 绥 冲 是 平滑 更 新 屏幕 上 图 形 的 泻 染 技术 。 系 统 维护 两 个 缓冲 
区 : 一 个 前 缓冲 区 和 后 缓冲 区 。 三 维 演 染 先 被 演 染 到 后 缓冲 区 ， 完 
成 时 ， 前 缓冲 区 与 后 缓冲 区 交换 内 容 。 由 于 缓冲 区 更 新 快速 发 生 ， 
这 种 技术 产生 了 更 流畅 的 视觉 效果 ， 尤 其 是 在 动画 时 。 双 缓冲 和 链 
接 到 OS 的 其 他 特征 一 样 ， 是 由 窗口 工具 包 〔( 在 这 个 例子 中 是 
GLFW) 提供 的 。 


9.4.3 Scene 类 














现在 来 看 看 Scene 类 ， 它 负责 初始 化 和 绘制 三 
维 几何 图 形 。 


class Scene: 
'" OpenGL 3D scene class""" 
# initialization 
def _ init (self): 
# create shader 
e self.program - glutils.loadShaders(strVS, strFS) 


eo glUseProgram(self.program) 


在 Scene 类 的 构造 函数 中 ， 先 编译 并 加 载 者 色 
器。 要 做 到 这 一 点 ， 我 利用 了 工具 方法 
loadShaders()@， 它 定义 在 glutils.py 中 ， 为 一 系列 
的 OpenGL 调 用 提供 了 一 个 方便 的 封装 ， 这 些 调用 
从 字符 串 加 载 厦 色 右 ， 编 译 它们 ， 并 将 它们 链接 成 
一 个 OpenGL 程 序 对 象 。 因 为 OpenGL 是 一 个 状态 
机 ， 所 以 需要 在 信行 调用 glUseProgram(), 设 置 代 码 
使 用 特定 的 “程序 对 象 ”( 因 为 一 个 项 目 可 能 有 多 个 
RH. 


MÆ, TfPythonfV RS PR 2e & 57:8 Cas rH IR AE 


量 连接 起 来 。 





























self.pMatrixUniform = glGetUniformLocation(self.program, b'uP 


self.mvMatrixUniform - glGetUniformLocation(self.program, b'u 
# texture 


self.tex2D = glGetUniformLocation(self.program, b'tex2D') 


这 段 代 码 利 用 glGetUniformLocation(0) 方 法 ， 取 
得 变量 uPMatrix、uMVMatrix 利 tex2DD 在 顶点 和 片段 
着色 器 站 的 位 置 。 然 后 这 些 位 置 可 以 用 来 为 着 色 器 
变量 赋值 。 
定义 三 维 几何 图 形 


先 为 正方 形 定义 三 维 几何 图 形 。 











# define triangle strip vertices 


e vertexData = numpy.array( 
[-0.5, -0.5, 0.0, 
0.5 


0.5, 0.0 
-0.5, 0.5, 0.0, 
0.5, 0.5, 0.0], numpy.float32) 


# set up vertex array object (VAO) 

eo self.vao - glGenVertexArrays(1) 
glBindVertexArray(self.vao) 
# vertices 

e self.vertexBuffer - glGenBuffers(1) 
glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 
# set buffer data 


glBufferData(GL ARRAY BUFFER, 4*len(vertexData), vertexData, 
GL STATIC DRAW) 
# enable vertex array 
® glEnableVertexAttribArray(®) 
# set buffer data pointer 


® 
glVertexAttribPointer(0, 3, GL FLOAT, GL FALSE, 0, None) 


# unbind VAO 
(7) glBindVertexArray(0) 


fter. 定义 三 角形 市 的 项 点 数组 ， 用 于 绘制 
正方 形 。 设 想 一 个 以 原点 为 中 心 ， 边 长 为 1.0 的 正方 


形 。 该 正方 形 的 左下 顶点 坐标 为 (-0.5, -0.5, 0.0)， 下 
一 个 顶点 〈 右 下 ) 坐标 为 (0.5， -0.5， 0.0)， 依 次 类 
推 。 坐 标的 顺序 是 GL_TRIANGLE_STRIP 的 顺序 。 
在 @ 行 ， 创 建 一 个 VAO。 绑 定 到 该 VAO 后 ， 接 下 
来 所 有 调用 将 绑 定 到 它 。 在 全 行 ， 创 建 一 个 VBO 来 
管理 顶点 数据 的 泻 染 。 绥 冲 区 绑 定 后 ， 第 @ 行 根据 
己 定 义 的 项 点， 设置 缓冲 区 数据 。 


现在 ， 需 要 让 着 色 右 能 访问 这 些 数 据 了 ， 这 在 
全 行 实现 。GlEnableVertexAttrib Array0O 被 调用 ， 下 
标 为 0， 因 为 这 是 你 在 项 点 看 色 需 中 设置 的 项 点 数 
据 变 量 的 位 置 。 在 @ 行 ，glVertexAttribPointerO 设 
置 了 顶点 属性 数组 的 位 置 和 数据 格式 。 属 性 的 下 标 
是 0， 组 件 个 数 是 3 使 用 三 维 顶 点 ) ， 顶 点 的 数据 
类 型 是 GL_FLOAT。 在 人 @ 行 取消 VAO 绑 定 ， 让 其 他 
的 相关 调用 不 会 干扰 它 。 在 OpenGL 中 ， 完 成 工作 
后 重 置 状 态 是 最 佳 实践 。OpenGEL 是 一 个 状态 机 ， 
所 以 如 果 留 下 一 个 烂 挫 子 ， 它 束 会 一 直 那 样 。 


下 面 的 代码 将 图 像 加 载 为 OpenGL 纹 理 : 




















# texture 
self.texId - glutils.loadTexture('star.png') 








返回 的 纹理 ID 稍 后 将 用 于 演 染 。 
下 一 步 ， 更 新 Scene 对 象 中 的 变量 ， 让 正方 形 








在 屏幕 上 旋转 : 


# step 
def step(self): 
# increment angle 
e self.t = (self.t + 1) % 360 
# set shader angle in radians 


glUniformif(glGetUniformLocation(self.program, 'uTheta'), 
math.radians(self.t)) 


EOF, BAIS A RARE A SEE AT 
(%) ， 保 持 该 值 在 [0，360] 的 范围 内 。 然 后 ， 在 
信行 利用 glUniform1f(0) 方 法 ， 在 着 色 器 程序 中 设置 
该 值 。 像 以 前 一 样 ， 用 glGetUniformLocation() 来 获 
得 着色 器 中 的 uTheta 角 变量 的 位 置 ， 而 Python 的 
math.radians() 方 法 将 度 转换 为 弧度 。 


现在 来 看 看 主要 有 的 泻 染 代码 : 

















# render 
def render(self, pMatrix, mvMatrix): 
# use shader 
e glUseProgram(self.program) 
# set projection matrix 
© 
glUniformMatrix4fv(self.pMatrixUniform, 1, GL_FALSE, pMatrix) 
# set modelview matrix 
glUniformMatrix4fv(self.mvMatrixUniform, 1, GL_FALSE, mvMat 
# show circle? 


glUniformii(glGetUniformLocation(self.program, b'showCircle') 


self.showCircle) 


# enable texture 


o glActiveTexture(GL TEXTUREO) 
® glBindTexture(GL TEXTURE 2D, self.texId) 
O glUniformii(self.tex2D, 0) 
# bind VAO 
(7) glBindVertexArray(self.vao) 
# draw 
e glDrawArrays(GL TRIANGLE STRIP, 0, 4) 
# unbind VAO 
© glBindVertexArray(0) 


在 人 @ 行 ， 设 置 演 染 使 用 着 色 嚣 程序。 然后 ， 从 
信行 开始 ， 利 用 glUniformMatrix4fv() 方 法 ， 在 着 色 
器 中 设置 计算 好 的 投影 和 模型 视图 矩阵 。 在 合 行 用 
glUniformli(), KEAR RE fas FshowCircle ff 
当前 值 。OpenGL 有 多 纹理 单元 的 概念 ， 
glActiveTexture) Om ACFE AICO RUE) . (E 
OiT. SEH MAMNAHID, WET, «i 
Ze. EOI, Hh BUB RP Dsampler2DAP s Y 7 
纹理 单元 0。 在 @ 行 ， 绑 定 到 先前 创建 的 VAO。 现 
在 你 看 到 了 使 用 VAO 的 好 处 了 : 实际 绘制 之 前 ， 不 














需要 重复 一 大 堆 顶 点 缓冲 相关 的 调用 。 在 全 行 ， 
DrawArrays() 被 调用 ， 泻 染 绑 定 的 项 点 绥 冲 区 。 





图 元 类 型 是 一 个 三 角形 带 ， 有 四 个 顶点 要 演 染 。 在 
自行 取 消 绑 定 VAO， 这 是 良好 的 编码 习惯 。 


EXNGLSLEER 
现在 让 我 们 看 看 项 目 中 最 精彩 的 部 分 : GLSL 





Hin. REMAKE: 


#version 330 core 
@ layout(location = 0) in vec3 avert; 
uniform mat4 uMVMatrix; 

uniform mat4 uPMatrix; 

uniform float uTheta; 


out vec2 vTexCoord; 


void main() { 
// rotational transform 
© mat4 rot = mat4( 
vec4(cos(uTheta), sin(uTheta), 0.0, 0.0), 
vec4(-sin(uTheta), cos(uTheta), 0.0, 0.0), 
vec4(0.0, 0.0, 1.0, 0.0), 
vec4(0.0, 0.0, 0.0, 1.0) 


); 
// transform vertex 


gl Position = uPMatrix * uMVMatrix * rot * vec4(aVert, 1.0); 
// set texture coordinate 

Q vTexCoord = aVert.xy + vec2(0.5, 0.5); 

} 


在 @ 行 ， 用 layout 关 键 字 明确 设置 顶点 的 位 置 
属性 aVert 在 这 个 例子 中 设置 为 0。 从 他 行 开始 ， 
声明 一 些 uniform 变 量 : 投影 和 模型 视图 矩阵 和 旋转 
角度 。 这 些 将 在 Python 代码 中 设置 。 在 个 行 ， 设 置 
一 个 二 维 矢 量 vTexCoord， 作 为 这 个 着 色 器 的 输 
出 。 它 将 作为 片段 着 色 器 的 输入 。 在 着 色 器 的 
main() 方 法 中 ， 在 人 @ 行 设立 旋转 矩阵 ， 它 围绕 z 轴 放 
转 给 定 的 角度 。 在 加 行 ， 利 用 投影 、 模 型 视图 和 旋 
转 矩 阵 级 联 来 计算 gl_Position。 在 @ 行 ， 设 置 一 个 








二 维 癌 量 作 为 纹理 坐标 。 你 可 能 还 记得 ， 你 定义 了 
三 角形 带 ， 表 示 以 原点 为 中 心 、 边 长 为 1.0 的 正方 

形 。 因 为 纹理 坐标 的 范围 是 [0,1]， 所 以 可 以 通过 在 
x 值 和 y 值 上 增加 (0.5， ”0.5)， 从 顶点 坐标 来 生成 它 
们 。 这 也 展示 了 着 色 器 的 计算 的 能 力 和 巨大 的 灵活 
性 。 弘 理 坐 标 和 其 他 变量 不 是 神圣 不 可 侵犯 的 ， 你 
可 以 将 它们 设置 为 任何 东西 。 


ME, RA AH Be Ei: 














#version 330 core 


@ in vec4 vCol; 
in vec2 vTexCoord; 


uniform sampler2D tex2D; 
® uniform bool showCircle; 


© out vec4 fragColor; 
void main() { 


if (showCircle) { 
// discard fragment outside circle 


® if (distance(vTexCoord, vec2(0.5, 0.5)) > 0.5) { 
discard; 

else { 
Q fragColor - texture(tex2D, vTexCoord); 

} 

} 

else { 
(7) fragColor = texture(tex2D, vTexCoord); 
} 


从 人 @ 行 开始 ， 定 义 了 片段 着 色 占 的 输入 : 就 是 





设置 为 顶点 着 色 器 的 输出 变量 的 那些 颜色 和 纹理 坐 
标 变量 。 回 想 一 下 ， 毛 段 着 色 丹 基于 每 个 像素 操 
作 ， 因 此 ， 对 这 些 变量 设置 的 值 是 针对 当前 像素 的 
值 ， 在 整个 多 边 形 中 内 插 。 在 信行 声明 了 
sampler2D 变 量 ， 它 被 连接 到 一 个 特定 的 纹理 单 

元 ， 用 于 碍 找 纹理 值 。 在 候 行 ， 声 明了 布尔 型 
uniform 标 志 ShowCircle， 这 是 从 Python 代码 中 设置 
的 ， 在 @@ 行 ， 声 明了 fragColor， 作 为 片段 着 色 器 的 
输出。 默认 情况 下 ， 会 显示 在 屏幕 上 《经 过 最 后 的 
帧 缓冲 区 操作 ， 如 深度 测试 和 混合 〉。 


如 果 没 有 设置 showCircle 标 志 ， 在 @@ 行 ， 使 用 
GLSEL 的 texture() 方 法 来 查找 纹理 颜色 值 ， 利 用 了 纹 
理 坐 标 和 采样 。 实 际 上 ， 你 只 是 用 星 形 图 像 来 设置 
三 角形 带 的 纹理 。 但 如 果 showCircle 标 志 为 真 ， 在 
合 行 ， 用 GLSL 的 内 置 方法 distance， 来 检查 当前 像 
素 离 多 边 形 的 中 心 有 多 远 。 出 于 这 个 目的 ， 它 使 用 

(内 插 的 ) 纹理 坐标 ， 这 是 由 顶点 着 色 器 传 入 的 。 
如 果 访 距离 大 于 某 一 国 值 〈 在 本 例 中 是 0.5) , A 
用 GLSL 的 discard 方 法 ， 丢 和 弃 当 前 像素 。 如 果 该 距 
ANTRE, WEOE XK HAHAE KAE. 
FKE, KEERA T AEDE ARAL, 
FERNOSNAZINBZ, MifEshowCirceik B. 
时 ， 切 割 访 多边形 ， 放 入 圆 中 。 


























9.5 ”完整 代码 


这 个 简单 的 OpenGL 应 用 程序 的 完整 代码 分 为 
两 个 文件 : simpleglfw.py， 包 含 下 面 展 示 的 代码 ， 
并 可 以 在 
https://github.com/electronut/pp/tree/master/simplegl/ 
找到 ;，glutils.py， 包 括 一 些 辅助 方法 ， 让 生活 更 轻 
松 ， 可 以 在 common 目 录 中 找到 。 


import OpenGL 
from OpenGL.GL import * 


import numpy, math, sys, os 
import glutils 


import glfw 


st rVS = nau 
Zversion 330 core 


layout(location = 0) in vec3 aVert; 


uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 
uniform float uTheta; 


out vec2 vTexCoord; 


void main() { 
// rotational transform 
mat4 rot - mat4( 
vec4(cos(uTheta), sin(uTheta), 0.0, 0.0), 
vec4(-sin(uTheta), cos(uTheta), 0.0, 0.0), 
vec4(0.0, 0.0, 1.0, 0.0), 
vec4(0.0, 0.0, 0.0, 1.0) 


) 


// transform vertex 


gl Position - uPMatrix * uMVMatrix * rot * vec4(aVert, 1.0); 
// set texture coordinate 
vTexCoord = aVert.xy + vec2(0.5, 0.5); 


strFS — nau 
Zversion 330 core 


in vec2 vTexCoord; 


uniform sampler2D tex2D; 
uniform bool showCircle; 


out vec4 fragColor; 


void main() { 
if (showCircle) { 
// discard fragment outside circle 
if (distance(vTexCoord, vec2(0.5, 0.5)) > 0.5) { 
discard; 


else { 
fragColor - texture(tex2D, vTexCoord); 
} 


else { 
fragColor = texture(tex2D, vTexCoord); 
j 


class Scene: 
""" OpenGL 3D scene class""" 
# initialization 
def _ init (self): 
# create shader 
self.program - glutils.loadShaders(strVS, strFS) 


glUseProgram(self.program) 
self.pMatrixUniform - glGetUniformLocation(self.program, b'uP 


self.mvMatrixUniform = glGetUniformLocation(self.program, b'u 
# texture 


self.tex2D = glGetUniformLocation(self.program, b'tex2D') 


# define triange strip vertices 
vertexData = numpy.array( 


[-0.5, -0.5, 0.0, 
0.5, -0.5, 0.0, 
-0.5, 0.5, 0.0, 
0.5, 0.5, 0.0], numpy.float32) 


# set up vertex array object (VAO) 

self.vao - glGenVertexArrays(1) 
glBindVertexArray(self.vao) 

# vertices 

self.vertexBuffer - glGenBuffers(1) 
glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 
# set buffer data 


glBufferData(GL ARRAY BUFFER, 4*len(vertexData), vertexData, 
GL STATIC DRAW) 
# enable vertex array 
glEnableVertexAttribArray(®) 
# set buffer data pointer 


glVertexAttribPointer(0, 3, GL FLOAT, GL FALSE, 0, None) 
# unbind VAO 
glBindVertexArray(0) 


# time 

self.t = 0 

# texture 

self.texId = glutils.loadTexture('star.png') 


# show circle? 
self.showCircle = False 


# step 

def step(self): 
# increment angle 
self.t = (self.t + 1) % 360 
# set shader angle in radians 


gluniformif(glGetUniformLocation(self.program, 'uTheta'), 
math.radians(self.t)) 


# render 

def render(self, pMatrix, mvMatrix): 
# use shader 
glUseProgram(self.program) 


# set projection matrix 
glUniformMatrix4fv(self.pMatrixUniform, 1, GL FALSE, pMatrix) 
# set modelview matrix 
glUniformMatrix4fv(self.mvMatrixUniform, 1, GL FALSE, mvMatri 
# show circle? 


glUniformii(glGetUniformLocation(self.program, b'showCircle') 
self.showCircle) 


# enable texture 

glActiveTexture(GL TEXTUREO) 
glBindTexture(GL TEXTURE 2D, self.texId) 
glUniformii(self.tex2D, 0) 


# bind VAO 
glBindVertexArray(self.vao) 

# draw 

glDrawArrays(GL TRIANGLE STRIP, 0, 4) 
# unbind VAO 

glBindVertexArray(0) 


class RenderWindow: 
"""GLFW Rendering window class""" 
def _ init (self): 


# save current working directory 
cwd = os.getcwd() 


# initialize glfw - this changes cwd 
glfw.glfwInit() 


# restore cwd 
os.chdir(cwd) 


# version hints 
glfw.glfwwindowHint(glfw.GLFW CONTEXT. VERSION MAJOR, 3) 
glfw.glfwwindowHint(glfw.GLFW CONTEXT. VERSION MINOR, 3) 
glfw.glfwwindowHint(glfw.GLFW OPENGL FORWARD COMPAT, GL TRUE) 


glfw.glfwwindowHint(glfw.GLFW OPENGL. PROFILE, 
glfw.GLFW OPENGL CORE PROFILE) 


# make a window 
self.width, self.height - 640, 480 
self.aspect - self.width/float(self.height) 


self.win - glfw.glfwCreatewindow(self.width, self.height, 
b'simpleglfw') 
# make context current 
glfw.glfwMakeContextCurrent(self.win) 


# initialize GL 

glViewport(0, 0, self.width, self.height) 
glEnable(GL_DEPTH_TEST) 

glClearColor (0.5, 0.5, 0.5, 1.0) 


# set window callbacks 


glfw.glfwSetMouseButtonCallback(self.win, self.onMouseButton) 
glfw.glfwSetKeyCallback(self.win, self.onKeyboard) 
glfw.glfwSetWindowSizeCallback(self.win, self.onSize) 


4 create 3D 
self.scene - Scene() 


# exit flag 
self.exitNow = False 


def onMouseButton(self, win, button, action, mods): 
#print 'mouse button: ', win, button, action, mods 
pass 


def onKeyboard(self, win, key, scancode, action, mods): 
#print 'keyboard: ', win, key, scancode, action, mods 
if action -- glfw.GLFW PRESS: 
# ESC to quit 
if key -- glfw.GLFW KEY ESCAPE: 
self.exitNow - True 
else: 
# toggle cut 


self.scene.showCircle - not self.scene.showCircle 


def onSize(self, win, width, height): 
#print 'onsize: ', win, width, height 
self.width - width 
self.height height 
self.aspect width/float(height) 
glViewport(0, ©, self.width, self.height) 


def run(self): 
# initializer timer 
glfw.glfwSetTime(®) 
t = 0.0 


while not glfw.glfwWindowShouldClose(self.win) and not self.e 
# update every x seconds 
currT = glfw.glfwGetTime() 
if currT - t > 0.1: 
# update time 
t = currT 
# clear 


glClear(GL COLOR BUFFER BIT | GL DEPTH BUFFER BIT) 
# build projection matrix 


pMatrix - glutils.perspective(45.0, self.aspect, 0.1, 100.0) 


mvMatrix - glutils.lookAt([0.0, 0.0, -2.0], [0.0, 0.0, 0.0], 
[0.0, 1.0, 0.0]) 
# render 
self.scene.render(pMatrix, mvMatrix) 
# step 
self.scene.step() 


glfw.glfwSwapBuffers(self.win) 
# poll for and process events 
glfw.glfwPollEvents() 


# end 
glfw.glfwTerminate() 


def step(self): 
# clear 
glClear(GL COLOR BUFFER BIT | GL DEPTH BUFFER BIT) 


# build projection matrix 
pMatrix - glutils.perspective(45.0, self.aspect, 0.1, 100.0) 
mvMatrix - glutils.lookAt([0.0, 0.0, -2.0], [0.0, 0.0, 0.0], 
[0.0, 1.0, 0.0]) 


# render 
self.scene.render(pMatrix, mvMatrix) 


# step 
self.scene.step() 


glfw.SwapBuffers(self.win) 
# poll for and process events 
glfw.PollEvents() 


# main() function 
def main(): 
print("Starting simpleglfw. " 
"Press any key to toggle cut. Press ESC to quit.") 
rw = RenderWindow() 


rw.run() 
# call main 
if name == ' main ': 


main() 


9.6 ”运行 OpenGL 应 用 程序 


下 面 是 该 项 目的 运行 示例 : 


$python simpleglfw.py 


输出 如 图 9-1 所 示 。 


现在 ， 让 我 们 快速 浏览 一 下 在 glutils.pie 中 定义 
的 一 些 工具 方法 。 这 个 方法 加 载 图 像 ， 作 为 
OpenGL: 


def loadTexture(filename): 
"""load OpenGL 2D texture from given image file""" 
img - Image.open(filename) 
(2) imgData = numpy.array(list(img.getdata()), np.int8) 
© texture = glGenTextures(1) 
@ glBindTexture(GL TEXTURE 2D, texture) 
® glPixelStorei(GL_UNPACK_ALIGNMENT, 1) 
® 
g 


lTexParameterf(GL TEXTURE 2D, GL TEXTURE WRAP S, GL CLAMP T 
glTexParameterf(GL TEXTURE 2D, GL TEXTURE WRAP T, GL CLAMP T 
glTexParameterf(GL TEXTURE 2D, GL TEXTURE MAG FILTER, GL LIN 
glTexParameterf(GL TEXTURE 2D, GL TEXTURE MIN FILTER, GL LIN 
glTexlImage2D(GL TEXTURE 2D, ©, GL RGBA, img.size[0], img.siz 


0, GL RGBA, GL UNSIGNED BYTE, imgData) 
return texture 


ÆT, loadTexture() K 205 Python Éd [A Fe 
(PIL) 的 Image 模 块 读 取 图 像 文件 。 然 后 在 信行 ， 
获取 Image 对 象 的 数据 ， 放 入 8 位 的 numpy 数 组 ， 在 
合 行 ， 创 建 一 个 OpenGL 纹 理 对 象 ， 这 是 在 OpenGL 
中 利用 纹理 做 任何 事 的 先决 条 件 。 在 @@ 行 ， 执 行 现 
在 你 比较 熟悉 的 绑 定 texture 对 象 ， 这 样 所 有 后 来 纹 
理 相 关 的 设置 都 应 用 于 该 对 象 。 在 @ 行 ， 将 数据 的 

拆 包 对 齐 设置 为 1!， 这 意味 着 该 图 像 数 据 被 硬件 认 
为 是 1 字 节 (或 8 位 〉 的 数据 。 从 人 @ 行 开始 ， 告 诉 
OpenGL 如 何 处 理 边缘 的 纹理 。 在 这 个 例子 中 ， 在 
几何 图 形 的 边缘 截取 纹理 其 色 【〈 指 定 纹 理 坐 标 时 ， 
惯例 是 使 用 字母 S 和 T 表 示 轴 ， 而 不 是 zx 和 y) 。 在 @@ 
行 和 下 一 行 ， 指 定 插值 类 型 ， 在 拉 伸 或 压缩 纹理 来 
敌 兰 多 边 形 时 采用 。 在 这 个 例子 中 ， 指 定 为 “线性 
JEW”. EOT, KAREA PRZ. JE 
时 ， 图 像 数据 传送 到 显存 ， 纹 理 准 备 好 使 用 了 。 

















9.7 小 结 





恭喜 你 完成 了 使 用 Python 和 OpenGEL 的 第 一 个 
程序 。 你 已 踏 上 进入 三 维 图 形 编程 迷人 世界 的 旅 


FE o 


98 ”实验 


下 面 有 一 些 修改 这 个 项 目的 想法 。 


1. 这 个 项 目 中 ， 顶 点 着 色 右 围绕 z 轴 (0，0， 
D 旋转 正方 形 。 你 能 让 它 绕 轴 (1，1，0) 旋转 
吗 ? 可 以 用 两 种 方式 实现 : 第 一 ， 修 改 着 色 器 中 的 
旋转 矩阵 ， 第 二 ， 在 Python 代码 计算 这 个 矩阵 ， 将 
它 作 为 一 个 uniform 传 入 着 色 嚣 。 两 种 方法 都 试 一 
Te 





2. 这 个 项 目 中 ， 纹 理 坐 标 在 顶点 着 色 器 内 产 
生 ， 并 传 入 片段 着 色 器 。 这 是 一 种 方法 ， 它 有 效 只 
征 因 为 三 角形 市 的 顶点 选择 了 方便 的 仁 。 请 将 纹理 
坐标 作为 捍 独 的 属性 传 入 顶点 着 色 人 器 ， 类 似 于 顶点 
传 入 的 方式 。 现 在 ， 你 能 让 星 形 纹理 平 铺 三 角形 带 
吗 ? 不 是 显示 一 笑星 ， 而 是 在 正方 形 上 生成 4x4 的 
ERE Gen: 使 用 大 于 1.0 的 纹理 坐标 ， 并 将 
glTexParameterf()F f}JIGL_TEXTURE_WRAP_S/TZ 
数 设置 为 GL_REPEAT) . 


3. 只 修改 片段 着 色 器 ， 能 让 你 的 正方 形 如 图 
9-7 所 示 〈 提 示 : 使 用 GLSL 有 的 sin(0) 函 数 )? 














图 9-7 ”使 用 户 段 痢 色 露 来 男 出 同心 


第 10 间 ”粒子 系统 








在 计算 机 图 形 世 界 中 ， 粒 子 系统 是 用 许多 小 图 
元 《如 点 、 线 、 三 角形 和 多 边 形 ) 来 表示 的 物体 ， 
WAS KK EELK, KAHILA, 
因此 很 难 用 标准 技术 来 建 模 。 


例如 ， 如 何在 计算 机 上 制造 一 次 爆炸 效果 ? 设 
想 爆 炸 从 空间 中 的 一 个 点 开始 ， 然 后 同 外 扩张 ， 作 
为 一 个 快速 扩大 的 、 复 末 的 三 维 实体 ， 随 时 间 而 改 
变形 状 和 颜色 。 不 夸张 地 说 ， 尝 试 建 并 数学 模型 就 
TAEMER. 


但 现在 设想 一 下 ， 焊 炸 包含 一 群 细小 的 粒子 ， 











每 个 粒子 有 关联 的 位 置 和 颜色 。 爆 炸 开 始 时 ， 镁 子 
在 空间 中 的 一 个 点 上 聚 成 一 图 。 随 着 时 间 的 推移 ， 
它们 根据 一 定 的 数学 规则 同 外 移动 ， 并 改变 闫 色 ， 
让 你 定期 绘制 所 有 粒子 ， 从 而 生成 爆炸 的 动画 。 利 
用 好 的 数学 模型 、 大 量 粒 子 ， 以 及 透明 上 度 和 公告 板 
(billboarding) 这 样 的 稼 染 技术 ， 可 以 创建 盘 真 的 
效果 ， 如 图 10-1 所 示 。 


本 项 目 会 制定 粒子 运动 的 数学 模型 ， 将 它 表示 
为 时 间 的 函数 ， 并 利用 图 形 处 理 单 元 (GPU) 的 看 
色 喜 进行 计算 。 然 后 ， 会 设计 一 种 演 染 方案 ， 利 用 
一 种 名 为 公告 板 的 技术 ， 它 让 二 维 图 像 一 直面 问 观 
众 ， 从 而 使 二 维 图 像 看 起 来 像 是 三 维 的 ， 用 一 种 令 
人 信服 的 方式 来 绘制 这 些 粒 子 。 还 会 用 OpenGL 独 
色 需 让 粒子 旋转 ， 并 生成 动 国 场 景 。 你 可 以 通过 鬼 
键 来 打开 或 关闭 各 种 效果 ， 进 行 比较 。 








eoo Particle System 
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图 10-1 已 完成 项 目的 运行 示例 


数学 模型 将 设置 每 个 粒子 的 初始 位 置 和 速度 ， 
并 决定 粒子 如 何 随时 间 运 动 。 你 可 以 让 每 个 纹理 的 
黑色 区 域 透明 ， 利 用 正方 形 图 像 创 建 火 花 ， 保 持 每 
个 火花 面 同 观 众 ， 使 它们 看 起 来 有 立体 感 。 你 会 生 
成 粒子 的 动画 ， 定 期 更 新 它们 的 位 置 ， 其 亮度 随 着 
时 间 的 推移 逐渐 减弱 。 


下 面 是 将 要 探索 的 一 些 概念 : 








。 制 定 喷 果 粒 子 系统 的 数学 模型 ; 

。 利 用 GPU 着 色 器 计算 ; 

。 利 用 纹理 和 公告 板 模拟 复杂 的 三 维 对 象 ; 

。 利 用 OpenGL 泻 染 功能 ， 如 混合 、 深 上 度 遮 手 和 
Alpha 通 道 ， 绘 制 半 透明 物体 ; 

。 利 用 相机 模型 绘制 三 维 透视 图 。 


10.1 工作 原理 


要 创建 动画 ， 束 需要 一 个 数学 模型 。 从 一 个 固 
定 把 开始， 移动 一 些 粒 子 ， 随 时 间 推 移 沿 抛 物 线 轨 
迹 运动 ， 形 成 火花 喷 果 ， 如 图 10-2 所 示 。 这 丈 是 顺 


果 粒 子 系统 。 
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图 10-2 5 个 示例 火花 在 喷泉 粒子 系统 中 的 轨迹 


我 们 的 粒子 系统 应 具有 以 下 特性 : 


。 粒 子 应 该 从 固定 点 的 出 现 ， 它 们 的 运动 轨迹 应 
该 是 抛物 线 ; 

© MS AREA FOR Ae Co BG Eg 
RE) ， 运 动 预定 距离 ; 

。 较 接近 喷 凡 垂直 轴 中 心 的 粒子 ， 应 该 比 离 中 心 
较 远 的 粒子 初速 度 更 大 ; 

. p TAMEK, [8] ERST To 
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10.1.1 为 粒子 运动 建 模 


假设 粒子 系统 包含 N 个 粒子 。 第 i 个 粒子 的 运动 
方程 如 下 : 











D s 
P, = Po T- Vot T zat” 


这 里 ，P 1 是 在 时 间 t 的 位 置 。P 0 为 粒子 的 初始 
PE, V 0 是 粒子 的 初始 速度 ，a 是 加 速度 。 可 以 认 
为 a 是 系统 中 的 重力 加 速度 ， 让 粒子 党 同 下 的 弧 线 
运动 。 

这 些 参数 都 是 三 维 问 量 ， 可 以 表示 为 三 维 坐 
标 。 例 如 ， 使 用 加 速度 值 是 0，0，-9.8) ， 这 征 
地 球 在 z 轴 《垂直 ) 方 回 的 重力 加速度， 单位 是 米 





每 平方 秒 。 
10.12 ”设置 最 大 范围 


要 让 噶 果 看 起 来 亿 真 ， 粒 子 应 相对 于 圆锥 体 的 
z 轴 ， 以 不 同 的 角度 飞 出 。 但 也 要 设置 一 个 最 大 范 
围 ， 让 每 个 粒子 的 初始 速度 在 一 定 范围 内 ， 让 这 些 
粒子 呈 汤 斗 状 ， 形 成 噶 果 的 样子 。 为 了 实现 这 个 目 
标 ， ee 如 图 
10-3 所 不 。 














图 10-3 ”限制 每 个 粒子 的 初始 速度 范围 。 每 个 粒子 分 配 的 速度 
在 阴影 加 内 








在 图 10-3 中 ， 方 位 角 qg 是 速度 同 量 与 x 轴 的 夹 
角 。 倾 斜 骨 9 是 速度 问 量 与 z 轴 的 夹 和 朋 。 倾 斜 角 的 选 
择 范围 让 速度 癌 量 处 于 图 中 浅 灰 色 阴 影 区 域内 。 


速度 方 同 应 该 从 大 圆圈 包围 的 半球 部 分 中 随机 
选择 。 这 些 方 同 的 端点 处 于 一 个 单位 半径 的 球面 
上 ， 这 样 束 可 以 用 球 坐 标 系 来 计算 它们 。 此 外 ， 我 
们 希望 速度 值 随 厦 与 轴 的 来 角 增 大 而 减 小 。 考 虑 到 
这 一 点 ， 粒 子 的 初始 速度 如 下 : 

Vi = (1-a?)V 

XX Hi, ERT NR SRA PE RM 
FH E20) 之 比 。 因 此 ， 随 着 这 个 比值 逐渐 变 为 
1.0， 速 度 〈 二 次 地 ) 下 降 。 速 度 V 古 单位 球面 上 一 
个 点 ， 像 下 面 这 样 : 


V = (cos(0) sin( 9), sin e(@) sin( 9). cos( ®)) 


fE[0, 20]BE yw E NEE TER, FE 
[0，360] 度 范围 内 随机 选择 一 个 方位 角 : 


0 = random(|0, 20]),  — random([0, 360]) 
这 个 方程 让 粒子 指 问 图 10-3 中 区 域内 的 一 
个 随机 点 《注意 ， 在 这 个 程序 中 ， 所 有 角度 计算 需 
要 用 弧度 ， 不 是 度 ) 。 
我 们 也 希望 确保 粒子 不 在 同一 时 间 开 始 〈 原 因 
请 参阅 10.10 市 )。 要 做 到 这 一 点 ， 为 每 个 粒子 计算 




















一 个 时 间 延 迟 ， 稍 后 在 计算 粒子 位 置 时 使 用 。 第 i 修 
粒子 的 延迟 计算 如 下 : 


tiag = 0.05: 


jx 6 77 Re ep Be ee CF EY BU E BE EZ ORY ? 
例如 ， 为 什么 用 0.05 作 为 延迟 时 间 ， 用 20 度 作为 最 
大 和 角度? 答案 是 实验 。 重 要 的 是 创建 一 个 基本 模 
型 ， 然 后 调整 这 些 利 数 ， 以 获得 最 佳 视 党 效果 。 改 
变 程 序 中 的 这 些 参数 ， 看 看 不同 的 值 如 何 影响 结 
A. 


10.13 EHRT 


演 染 粒子 的 一 种 简单 方式 ， 就 是 将 它们 绘制 为 
点 。OpenGL 有 GL_POINTS 图 元 ， 本 质 上 是 屏幕 上 
的 一 个 点 ;你 可 以 控制 点 的 像素 大 小 和 颜色 。 但 我 
W000 0 


从 尖 开 始 绘 制 火 花 太 复杂 了 ， 所 以 需要 一 张 火 
化 的 照片 ， 作 为 纹理 粘贴 到 一 个 矩形 (也 称 为 “四 
边 形 ”) 。 喷 凡 中 的 每 个 粒子 都 被 绘制 成 火花 的 三 
角形 纹理 图 像 。 但 是 ， 这 提出 两 个 问题 。 首 先 ， 不 
布 望 正方 形 火化 ， 因 为 那 显 得 很 假 。 其 次 ， 如 果 从 
At f SUE. DUDEN BAT S. 


10.1.4 利用 OpenGEL 混合 来 创建 更 逼真 火 














化 


为 了 创造 更 逼真 的 火花 ， 我 们 利用 OpenGL 的 
混合 (blending) > HARARE FREER 
执行 之 后 和 帧 绥 冲 区 中 己 有 的 内 容 。 这 项 操作 通 
第 涉及 Alpha 通 道 。 


例如 ， 假 设 在 屏幕 上 绘制 两 个 多 边 形 ， 并 想 将 
它们 混合 在 一 起 。 你 可 以 用 alpha 混 合 的 技巧 ， 它 的 
工作 原理 是 将 两 个 透明 片 重 登 起 来 。alpha 通 道 表 示 
像素 的 不 透明 度 ， 它 是 透明 程度 的 量度 。 除 了 表示 
一 个 像素 颜色 的 红 、 绿 、 赣 分 量 之 外 ， 还 可 以 存储 
一 个 alpha 值 ， 得 到 的 颜色 方案 称 为 RGBA。 对 于 32 
位 的 RGBA 颜 色 方 案 ，alpha 值 的 范围 是 [0,255]，0 
是 完全 透明 ，255 是 完全 不 透明 。alpha 通 道 本 喘 不 
做 任何 事情 。 只 有 用 alpha 值 来 改变 像素 的 最 终 RGB 
值 时 ， 才 会 创建 各 种 透明 效果 。 


OpenGL 提 供 了 几 种 方法 来 定制 混合 方程 。 对 
于 喷 景 粒子 ， 我 们 将 使 用 图 10-4 所 示 的 纹理 ， 但 要 
让 纹理 的 黑色 区 域 消 失 ， 这 样 就 会 只 看 到 火花 。 


局 用 OpenGL 的 混合 ， 用 片段 的 alpha 值 乘 以 纹 
理 的 颜色 ， 可 以 让 黑色 区 域 消 失 。 对 于 黑色 区 域 ， 
RGB (0, 0, 0) ， 如 果 乘 以 alpha 值 ， 将 
得 到 0。 因 此 ， 经 过 混合 ， 黑 色 区 域 在 最 终 图 像 中 
的 不 透明 度 是 0， 你 看 到 的 只 是 背景 颜色 ， 实 际 上 




















去 掉 了 火花 纹理 的 黑色 区 域 (alpha 值 在 片段 着 色 器 
中 设置 ， 在 10.3.5 节 中 有 介绍 ) 。 


RGB = (0, 0, 0) 





m RGB = (255, 255, 255) 


图 10-4 火花 纹理 ， 标 有 RGB 值 (0, 0, 0) 为 黑色 ， (255, 
255, 255) 为 白色 


— 
VER 


除了 在 着 色 器 中 设置 alpha 值 ， 也 可 以 利用 纹理 图 像 中 的 alpha 
通道 ， 为 黑色 和 日 色 区 域 设 定 不 同 的 alpha 值 ， 从 而 控制 透明 度 。 在 
着 色 器 中 使 用 alpha 值 ， 创 建 种 有 黑色 背景 的 纹理 ， 再 让 所 有 黑色 区 
域 透明 ， 这 更 简单 ， 优 于 在 纹理 中 使 用 alpha 通 道 ， 让 特定 区 域 有 不 
同 的 透明 度 值 。 


10.1.5 ”使 用 公告 板 


HTE AE CRM Aa, P 
边 形 的 方 网 不 对 ) ， 我 们 将 使 用 公告 板 。 我 们 不 是 
绘制 复杂 的 三 维 物体 ， 而 是 放置 一 个 二 维 的 图 卢 ， 
让 你 总 是 看 到 其 正面 《 面 问 观看 的 方 同 ) ， 作 为 一 
种 公告 板 。 例 如 ， 在 开 友 三 维 游戏 时 ， 背 景 是 树木 
景观 ， 可 以 用 一 个 融 纹 理 的 多 边 形 公告 板 来 亚 代 树 














木 景观 。 只 要 玩家 徘 得 不 太 近 ， 假 的 “图 片 树 ” 看 起 
RAN RIE R o 

现在 来 看 看 放置 多 边 形 背后 的 数学 ， 以 便 让 它 
总 是 面向 观看 的 方向 。 图 10-5 展 示 了 如 何 将 一 个 纹 
理 四 边 形变 成 一 个 公告 极 。 


(近似 同上 辣 量 ) 














U 


Ag Er) 






uxn 


(多 边 形 法 向 /观看 方向 相反 ) 


图 10-5 ”公告 板 





对 准 是 相对 于 四 边 形 上 的 定位 点 来 说 的 。 在 这 
个 例子 中 ， 会 选择 四 边 形 的 中 心 。 要 对 准 四 边 形 ， 
需要 三 个 正 交 问 量 ， 创 建 一 个 小 坐标 系统 。 我 们 感 
兴趣 的 第 一 个 回 量 是 n， 代 表 四 边 形 的 法 线 问 量 。 
法 线 癌 量 牌 且 于 四 边 形 所 在 的 平面 ， 这 意味 看 设 定 
的 法 线 问 量 方 同 ， 就 是 四 边 形 面 同 的 方 辐 。 我 们 硕 
望 四 边 形 面 癌 观看 的 方向 ， 即 v， 所 以 n 回 量 需 要 对 
准 该 向 量 ， 但 方向 相反 。 因 为 观看 的 方向 朝向 屏 
幕 ， 所 以 四 边 形 的 法 线 问 量 应 该 指 同 相反 的 方 问 : 
从 屏幕 问 外 。 


这 意味 着 我 们 希望 方向 mn = -v。 现 在 ， 选 择 一 
个 向 量 w， 这 是 四 边 形 最 终 位 置 的 近似 向 上 向量 。 
选择 u 为 0，0，1) ， 因 为 z 方 向 指 “ 同 上 ”( 说 这 
个 同 量 是 近似 的 ， 是 因为 虽然 我 们 事先 知道 四 边 形 
的 法 线 辐 量 ， 但 不 知道 摄像 头 的 方向 ) 。 然 后 计算 
第 三 个 向 量 r， 这 里 r = uxn (两 个 向 量 的 又 积 ) 。 
现在 有 了 两 个 正 交 向 量 ，n 和 r， 都 在 四 边 形 的 平面 
中 。 叉 积 这 两 个 同 量 ， 得 到 一 个 新 问 量 。 因 此 ， 得 
到 了 新 的 同上 辣 量 u' = nxr 2nx (uxn)。 我 们 需要 一 
个 新 的 回 上 辣 量 ， 以 确保 这 3 个 问 量 是 正 交 的 ， 或 
彼此 垂直 。 最 后 ， 在 计算 过 程 中 ， 这 些 向 量 都 需要 
归 一 化 ， 让 长 度 等 于 一 个 单位 ， 从 而 创建 一 个 正 交 
坐标 系 〈《 其 中 所 有 问 量 是 单位 长 上 度 并 有 昌 正 交 ) 。 有 
了 这 3 个 同 量 ， 就 可 以 根据 三 维 图 形 理 论 ， 用 一 个 
旋转 矩阵 进行 任意 方 回 的 旋转 。 旋 转 和 矩阵 R 将 位 于 





















































原点 的 正 交 坐标 系统 旋转 到 r、u” 和 n 构 成 的 坐标 系 
统 : 


T3 tis nr O 
ry u y ny 0 
r. w. n. 0 
0 0 O 1 


应 用 这 个 旋转 矩阵 ， 将 带 纹 理 的 四 边 形 正确 地 
对 准 观 看 的 方向 ， 使 其 成 为 一 个 公告 板 。 
10.16 ”生成 火花 动画 


BERKER, MERAH GLEW, 
通过 更 新 泻 染 和 时 间 ， 定 时 绘制 粒子 系统 的 各 个 位 
B. 


R= 











10.2. ”所 需 模块 


我 们 将 用 PyOpenGL (一 个 流行 的 Python 
OpenGL E) 来 泻 染 ， 用 numpy 的 数组 来 表示 三 维 
坐标 变换 和 矩阵 。 


10.3. ”粒子 系统 的 代码 


我 们 开始 先 定 义 喷 凡 中 使 用 的 粒子 的 三 维 几 何 
形状 。 然 后 ， 再 看 看 如 何 创 建 动画 中 粒子 之 间 的 时 
间 延 壕 ， 如 何 为 粒子 设置 初始 速度 ， 以 及 如 何在 程 
序 中 使 用 OpenGL 的 顶点 和 片段 着 色 嚣 。 最 后 ， 看 
看 如 何 将 所 有 这 些 整合 起 来 ， 泻 染 粒子 系统 。 整 个 
项 目的 代码 ， 请 直接 跳 到 10.4 市 。 

噶 果 的 代码 封装 在 一 个 类 中 ， 名 为 
ParticleSystem， 它 创建 了 粒子 系统 ， 建 并 了 
OpenGL 着 色 器 ， 用 OpenGL 泻 染 系 统 ， 每 隔 五 秒 钟 
重新 开始 动画 。 


10.3.1 定义 粒子 的 几何 形状 














首先 ， 创 建 一 个 顶点 数组 对 象 (VBO ) 来 管理 
后 续 的 顶点 属性 数组 ， 从 而 定义 这 些 粒 子 的 几何 形 


状 。 


# create Vertex Array Object (VAO) 
self.vao - glGenVertexArrays(1) 

# bind VAO 
glBindVertexArray(self.vao) 


每 个 粒子 是 一 个 正方 形 ， 其 顶点 和 纹理 坐标 定 
义 如 下 : 


# vertices 
s = 0.2 
e quadV = [ 
-s, S, 0.0, 
-S, -S, 0.0, 
S, S, 0.0, 
S, -S, 0.0, 
S, S, 0.0, 
-S, -S, 0.0 
] 
vertexData = numpy.array(numP*quadV, numpy.float32) 
® self.vertexBuffer = glGenBuffers(1) 
©  glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 
e 
g 


lBufferData(GL_ARRAY_BUFFER, 4*len(vertexData), vertexData, 
GL_STATIC_DRAW) 


# texture coordinates 


Q quadT = [ 

0.0, 1.0, 
0.0, 0.0, 
1.0, 1.0, 
1.0, 0.0, 
1.0, 1.0, 
0.0, 0.0 
] 


tcData = numpy.array(numP*quadT, numpy.float32) 
self.tcBuffer = glGenBuffers(1) 
glBindBuffer(GL ARRAY BUFFER, self.tcBuffer) 


glBufferData(GL ARRAY BUFFER, 4*len(tcData), tcData, GL STATI 


在 转行 ， 定 义 了 正方 形 的 顶点 ， 各 边 以 原点 为 
中 心 ， 长 度 为 0.4。 对 于 两 个 GL_TRIANGLES， 顶 
点 的 排序 是 相同 的 。 然 后 ， 在 信行 ， 将 这 些 顶点 重 
复 numP 次 ， 创 建 一 个 numpy 数 组 : 每 个 四 边 形 表示 


系统 中 的 一 个 粒子 《所 有 要 绘制 的 几何 图 形 都 放 入 
到 一 个 大 数组 ) 。 


接 下 来 ， 将 这 些 顶 点 放 入 一 个 顶点 绥 冲 区 对 
象 ， 束 像 在 第 9 章 中 所 做 的 一 样 。 在 合 行 创建 
VBO， 在 人 @ 行 绑 定 。 然 后 在 @ 行 ， 用 顶点 数据 填充 
绑 定 的 绥 冲 区 。 代 码 4 * ”len(vertexData) 指 明 在 
vertexDataZt2H rH, BIT ZUR na AT Y e 


最 后 ， 在 @@ 行 定义 四 边 形 的 纹理 坐标 ， 随 后 儿 
行 代码 设置 了 相关 的 VBO。 


10.3.2 ”为 粒子 定义 时 间 延 迟 数组 


接 下 来 ， 为 粒子 定义 时 间 延 迟 数组 。 我 们 而 望 
每 组 四 个 顶点 的 时 间 延 迟 一 样 ， 这 代表 一 个 正方 形 
的 粒子 ， 如 以 下 代码 所 示 : 


# time lags 
timeData = numpy.repeat(0.005*numpy.arange(numP, dtype=numpy. 
4) 


self.timeBuffer = glGenBuffers(1) 
glBindBuffer(GL ARRAY BUFFER, self.timeBuffer) 


glBufferData(GL ARRAY BUFFER, 4*len(timeData), timeData, 
GL STATIC DRAW) 


在 @ 行 ，numpy.arange0 创 建 了 一 个 数组 ， 包 
含 不 断 增加 的 值 ， 即 [0，1，.…，numP-1]。 将 这 个 


数组 乘 以 0.005， 用 参数 4 调用 numpy.repeat0， 产 生 
一 个 数组 ， 即 [0.0，0.0，0.0，0.0，0.005，0.005， 


0.005， 
10.3.3 
接 下 来 生成 粒子 的 初始 速度 。 我 们 的 目标 是 生 


0.005，...]。 接 下 来 的 代码 设置 了 VBO。 


设置 粒子 初始 速度 


成 一 些 随 机 的 速度 ， 它 们 与 垂直 轴 的 夹 角 不 超过 茶 
个 最 大 值 。 下 面 是 代码 : 


® 


0 


# velocites 
velocities = [] 
# cone angle 
coneAngle = math.radians(20.0) 
# set up particle velocities 
for i in range(numP): 
# inclination 
angleRatio = random.random( ) 
a = angleRatio*coneAngle 
# azimuth 
t = random.random()*(2.0*math.pi) 
# get velocity on sphere 
vx = math.sin(a)*math.cos(t) 
vy math.sin(a)*math.sin(t) 
vz = math.cos(a) 
# speed decreases with angle 
speed = 15.0*(1.0 - angleRatio*angleRatio) 
# add a set of calculated velocities 
velocities += 6*[speed*vx, speed*vy, speed*vz] 
# set up velocity vertex buffer 
self.velBuffer - glGenBuffers(1) 
glBindBuffer(GL ARRAY BUFFER, self.velBuffer) 
velData - numpy.array(velocities, numpy.float32) 


glBufferData(GL ARRAY BUFFER, 4*len(velData), velData, GL STA 


(Ee. KEM T IREE AT VOR EAR 





(注意 ， 用 内 置 math.radians() 方 法 ， 将 角度 转换 为 
ME) 接 下 来 ， 用 10.1.1 节 中 讨论 的 公式 ， 计 算 
每 个 粒子 的 速度 。 


在 信行 ， 生 成 一 个 随机 分 数 ， 后 面 一 行 用 它 乘 
以 最 大 倾斜 和 骨 ， 来 计算 当前 倾斜 角 。 接 着 ， 在 全 行 
生成 方位 角 ， 因 为 random.random() 返 回 值 在 [0，1] 
之 间 ， 所 以 用 该 值 乘 以 2.0 * math.pi， 得 到 0 至 2 的 一 
个 随机 弧度 。 


从 和 @ 行 开始 ， 利 用 球 坐 标 公 式 ， 计 算 单 位 球面 
上 的 速度 同 量 。 在 加 行 ， 用 灸 行 得 到 的 角度 比 算 出 
一 个 速度 ， 它 与 焉 直角 度 成 反比 。 在 全 行 ， 计 算 粒 
子 的 最 终 速 度 ， 并 针对 两 个 三 角形 的 所 有 6 个 项 
点 ， 重 复 这 个 值 。 在 @ 行 ， 利 用 Python 列 表 创建 一 
个 nhumpy 的 数组 ， 这 就 可 以 为 这 些 速 上 度 创建 一 个 
VBO 了。 最 后 ， 启 用 所 有 的 项 点 属性 ， 并 为 项 点 绥 
冲 区 设置 数据 格式 (因为 这 个 过 程 类 似 于 第 9 章 ， 
KEKI, Bea ea) o 


10.3.4 创建 顶点 着 色 器 


顶点 看 色 带 处 理 各 个 顶点 ， 从 而 计算 粒子 系统 
的 轨迹 。 下 面 是 它 的 代码 ; 














Zversion 330 core 


in vec3 aVel; 
in vec3 aVert; 


in float aTime0; 

in vec2 aTexCoord; 
uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 
uniform mat4 bMatrix; 
uniform float uTime; 
uniform float uLifeTime; 
uniform vec4 uColor; 
uniform vec3 uPos; 


out vec4 vCol; 
out vec2 vTexCoord; 


TRETEN ET ERAT. ST 
系统 中 的 所 有 四 边 形 。 它 首先 定义 属性 数组 中 的 一 
些 变 量 ， 它 代表 要 传 入 VBO 的 数组 。 然 后 定义 一 些 
uniform 变 量 ， 它 们 在 执行 着 色 吉 时 保持 不 变 。 最 后 
定义 out 数 量 ， 它 们 在 顶点 着 色 右 中 设置 ， 并 传递 给 
片段 着 色 器 进行 插值 。 


ME, XERA Cirman) AŽ: 




















void main() { 
// set position 
@ float dt = uTime - aTime0， 
float alpha = clamp(1.0 - 2.0*dt/uLifeTime, 0.0, 1.0); 
@ if(dt < 0.0 || dt > uLifeTime || alpha < 0.01) { 
// out of sight! 
gl Position - vec4(0.0, 0.0, -1000.0, 1.0); 


else { 
// calculate new position 
o vec3 accel - vec3(0.0, 0.0, -9.8); 


// apply a twist 
float PI - 3.14159265358979323846264; 


float theta = mod(100.0*length(aVel)*dt, 360.0)*PI/180.0; 


Q 
mat4 rot = mat4(vec4(cos(theta), sin(theta), 0.0, 0.0), 
vec4(-sin(theta), cos(theta), 0.0, 0.0), 
vec4(0.0, 0.0, 1.0, 0.0), 
vec4(0.0, 0.0, 0.0, 1.0)); 
// apply billboard matrix 
(7) vec4 pos2 = bMatrix*rot*vec4(aVert, 1.0); 
// calculate position 
e 


vec3 newPos = pos2.xyz + uPos + aVel*dt + 0.5*accel*dt*dt; 
// apply transformations 
© 


gl Position = uPMatrix * uMVMatrix * vec4(newPos, 1.0); 
// set color 

@ vCol = vec4(uColor.rgb, alpha); 
// set texture coordinates 
vTexCoord = aTexCoord; 


j 


在 转行 ， 针 对 特定 的 粒子 计算 当前 经 过 的 时 
间 ， 这 是 当前 时 间 步 又 与 访 粒 子 的 延迟 时 间 之 间 的 
差 。 然 后 在 全 行为 顶点 计算 alpha 值 ， 该 值 随 着 时 间 
的 流逝 而 减 小 ， 让 粒子 逐渐 淡出 。 利 用 GLSL 中 的 
clamp()， 将 值 限制 在 范围 [0，1] 之 内 。 


为 了 在 粒子 生命 周期 结束 时 让 粒子 消失 ， 将 它 
们 放 在 OpenGEL 的 视 锥 之 外 ， 这 样 它 们 会 被 裁 甬 
挤 。 在 信行， 检查 粒子 的 生命 周期 是 否 结束 (根据 
粒子 系统 构造 水 数 中 的 设置 ) ， 或 者 其 alpha 值 低 于 
特定 值 ， 这 时 将 最 终 位 置 设置 到 视 锥 之 外 。 


在 @ 行 ， 设 置 粒子 加 速度 为 9.8 米 / 秒 *， 即 由 于 
地 球 引 力 而 产生 的 加 速度 。 当 粒子 以 较 高 的 初始 速 











度 飞 出 顺 果 时 ， 为 了 让 它们 快速 旋转 ， 使 用 mod0) 
方法 (类 似 于 Python 的 取 模 运算 %)〉 ， 在 @ 行 ， 将 
角度 值 限制 在 范围 [0，360] 之 内 。 在 @ 行 ， 利 用 这 
个 计算 出 的 角度 ， 绕 四 边 形 的 z 轴 旋转 ， 根 据 绕 z 轴 
旋转 角度 的 变换 矩阵 公式 ， 像 下 面 这 样 : 


U.U 0.0 0.0 0.0 
0.0 0.0 0.0 1.0 


Rọ,- = 





在 @@ 行 ， 对 粒子 的 项 点 应 用 两 个 转换 ， 刚刚 计 
算出 的 旋转 和 用 bMatrix 的 公告 板 旋转 。 在 合 行 ， 利 
用 前 面 讨论 的 运动 方程 ， 计 算 顶 点 的 当前 位 置 (该 
行 中 的 uPos 只 是 让 你 任意 指定 喷 凡 原点 的 位 置 ) 。 

在 引 行 ， 对 粒子 位 置 应 用 模型 视图 和 投影 矩 
Me. Ba, FETA RTH, RANE oe 
Akin, EARRA Basile OAE, (EO 
基于 计算 设置 顶点 的 alpha 值 ) 。 


10.3.5 ”创建 片段 着 色 器 
" HE, REBAR BCE, VB 








Zversion 330 core 


uniform sampler2D uSampler; 
in vec4 vCol; 
in vec2 vTexCoord; 


out vec4 fragColor; 


void main() { 
// get the texture color 


vec4 texCol = texture2D(uSampler, vec2(vTexCoord.s, vTexCoord 


// multiply texture color by set vertex color; use the ver 
 fragColor = vec4(texCol.rgb*vCol.rgb, vCol.a); 


在 @ 行 ， 用 GLSL 的 texture2D0O 方 法 ， 利 用 从 
顶点 着 色 恬 传 入 的 纹理 坐标 ， 为 火花 图 像 查 找 基础 
纹理 颜色 (从 用 作 纹 理 的 图 像 中 查找 的 颜色 ) 。 然 
后 ， 将 这 个 纹理 颜色 值 乘 以 火花 喷 凡 的 颜色 ， 并 将 
FENDER E28 48] HH AE SEfragColor) . mi UPS 
色 是 在 每 个 粒子 系统 重新 启动 时 ， 由 ParticleSystem 
的 Apre eis 随机 设置 的 。alpha 值 是 根据 顶点 着 

器 中 的 计算 来 设置 的 ， 并 在 泻 染 时 用 于 混合 。 


10.3.6 HÀ 
ASF RE LUI PFARREI NT RER: 
1. 局 用 顶点 / 厂 断 程序 ; 
2. 设置 模型 视图 和 投影 矩阵 ; 


3. 基于 当前 摄像 机 的 观看 方向 ， 计 算 并 设置 
公告 板 窍 阵 ; 


4. 针对 人 位置、 时间 、 生 命 周期 和 颜色 ， 设 置 








uniform ® s ; 


5. 针对 项 点、 纹理 坐标 、 时 间 延 迟 和 速度 ， 
设置 顶点 属性 数组 ; 


6. 局 用 纹理 并 绑 定 到 粒子 火花 纹理 ; 
7. 禁用 深度 缓冲 写 入 ; 
8. 启用 OpenGL 的 泥 合 ; 
绘制 几何 图 形 。 
让 我 们 来 看 看 实现 其 中 一 些 步 又 的 代码 片段 。 
计算 公告 板 的 旋转 矩阵 
这 上 段 代 人 码 计 算 公 告 板 的 旋转 矩阵 : 











= camera.eye - camera.center 
/= numpy.linalg.norm(N) 
= camera.up 
/= numpy.linalg.norm(U) 
R = numpy.cross(U, N) 
U2 = numpy.cross(N, R) 
(2) bMatrix = numpy.array([R[0], U2[0], N[O], 0.0, 
R[1], U2[1], N[1], 6.6, 
R[2], U2[2], N[2], 6.6, 


cazz 


0.0, 0.0, 0.0, 1.0], numpy.float32) 


glUniformMatrix4fv(self.bMatrixU, 1, GL_TRUE, bMatrix) 


你 已 经 看 到 了 构造 一 个 旋转 矩阵 背后 的 理论 ， 


该 矩阵 让 四 边 形 保持 为 “公告 板 ?， 即 对 准 观 看 方 癌 
(这 是 必需 的 ， 以 便 让 喷 景 粒子 总 是 面 对 观 察 的 方 
H) © fE€M 7. Hinumpy.linalg.norm()XJ [7] 5&3 — 
化 (这 使 得 回 量 的 大 小 等 于 1) . EOT, Free 
矩阵 组 闭 为 一 个 numpy 数 组 ， 然 后 在 全 行将 它 放 入 
程序 中 。 


主要 的 泻 染 代码 


主要 的 演 染 代码 用 alpha 混 合 ， 让 粒子 系统 有 
透明 性 。 这 种 技术 在 OpenGL 中 常用 于 泻 染 半 透 明 
物体 。 











# enable texture 
e glActiveTexture(GL TEXTUREO) 
(2) glBindTexture(GL TEXTURE 2D, self.texid) 
e glUniformii(self.samplerU, 0) 


# turn depth mask off 
if self.disableDepthMask: 
o glDepthMask(GL FALSE) 


# enable blending 

if self.enableBlend: 
[5] glBlendFunc(GL SRC ALPHA, GL ONE) 
Q glEnable(GL BLEND) 


# bind VAO 


(7) glBindVertexArray(self.vao) 
# draw 
e glDrawArrays(GL TRIANGLES, 0, 6*self.numP) 


在 代行 ， 激 活 第 一 个 OpenGL 纹 理 单元 
(GL_TEXTUREO) 。 我 们 只 有 一 个 纹理 单元 ， 但 





由 于 在 OpenGL 上 下 文中 ， 同 一 时 间 可 以 激活 多 个 
纹理 单元 ， 所 以 针对 每 个 纹理 单元 显 式 调用 是 民 好 
的 编程 习惯 。 在 人 信行， 激活 纹理 对 象 ， 它 是 在 
ParticalSystem 的 构造 函数 中 ， 利 用 
glutils.loadTexture() 和 火花 图 像 创 建 的 。 


纹理 利用 采样 在 着 色 器 中 访问 ， 在 @ 行 ， 设 置 
采样 变量 使 用 第 一 个 纹理 单元 GL_TEXTURE0。 然 
后 ， 利 用 OpenGL 混 合 切除 纹理 中 的 黑色 像素 ， 但 
这 些 “ 看 不 见 ” 的 像素 仍然 共有 关联 的 深度 值 ， Tu 
掩盖 那些 在 它们 后 面 的 、 其 他 粒子 的 某 些 部 分 。 为 
了 避免 这 种 情况 ， 在 人 外行 禁用 深度 缓存 写 入 。 


— 
VER 











严格 来 说 ， 这 是 错误 的 绘制 方式 ， 因 为 如 果 混 合 这 些 半 透明 的 
a 它们 的 深度 测试 就 不 正确 。 泻 染 这 样 的 场 

， 正 确 的 做 法 应 该 是 先 绘制 不 透明 的 物体 ， 然 后 局 用 混合 ， 按 深 
度 从 后 到 前 对 半 透 明 物 体 排序 ， 最 后 绘制 它们 。 但 是 ， 因 为 有 这 么 
多 运动 的 粒子 ， 这 个 简单 的 近似 是 可 以 接受 的 ， 而 且 最 后 ， 它 看 起 
来 不 错 ， 而 这 才 是 你 关心 的 。 


在 加 行 ， 设 置 OpenGL 混 合 功能 ， 以 便 使 用 从 
片段 着 色 嚣 传 入 的 源 像素 的 alpha 值 ， 在 @@ 行 ， 启 用 
OpenGL 混 合 。 人 然后， 在 @ 行 绑 定 到 创建 的 VAO， 
picis :建立 的 所 有 的 顶点 属性 ， 在 候 行 ， 在 屏 

上 绘制 绑 定 的 顶点 缓冲 区 对 象 。 





10.3.7 Cameras 


最 后 ，Camera 类 设置 了 OpenGL 的 观看 参数 : 


# a simple camera class 
class Camera: 
"""helper class for viewing""" 
@ def init (self, eye, center, up): 
self.r - 10.0 
self.theta = 0 
self.eye = numpy.array(eye, numpy.float32) 
self.center - numpy.array(center, numpy.float32) 
self.up - numpy.array(up, numpy.float32) 


def rotate(self): 
"""rotate eye by one step""" 


(2) self.theta = (self.theta + 1) % 360 
# recalculate eye 
e self.eye = self.center + numpy.array([ 


self.r*math.cos(math.radians(self.theta)), 
self.r*math.sin(math.radians(self.theta)), 
0.0], numpy.float32) 


三 维 立 体 图 的 特征 通常 在 于 3 个 参数 : 眼睛 位 
aA, m En eR mms. Camera B2 3x 67 
数 ， 并 提供 了 一 种 便捷 的 方式 ， 在 每 一 个 时 间 步 又 
旋转 。 

在 @ 行 的 构造 函数 设置 了 camera 对 象 的 初始 
值 。 调 用 rotate() 方 法 时 ， 增 加 旋转 角度 信 ， 并 计算 
旋转 后 新 的 眼睛 位 置 和 方 癌 个 。 


— 




















点 (r cos(0), r sin(9)) 表 示 一 个 点 ， 它 在 以 原点 为 中 心 、 半 径 为 r 
的 圆 上 ，6 是 该 点 到 原点 的 连 线 与 x 轴 的 夹 角 。 转 换 中 使 用 了 
center， 确 保 即 使 旋转 中 心 不 在 原 点 ， 也 能 工作 。 


10.4 粒子 系统 完整 代码 


这 是 粒子 系统 的 完整 代码 。 也 可 以 在 
https://github.com/electronut/pp/tree/master/ particle- 
system/ps.py 找 到 它 。 


import sys, random, math 
import OpenGL 

from OpenGL.GL import * 
import numpy 

import glutils 


st rVS = nn 
Zversion 330 core 


in vec3 aVel; 

in vec3 aVert; 

in float aTime®; 
in vec2 aTexCoord; 


uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 
uniform mat4 bMatrix; 
uniform float uTime; 
uniform float uLifeTime; 
uniform vec4 uColor; 
uniform vec3 uPos; 


out vec4 vCol; 
out vec2 vTexCoord; 


void main() { 
// set position 
float dt = uTime - aTime®; 
float alpha = clamp(1.0 - 2.0*dt/uLifeTime, 0.0, 1.0); 
if(dt < 0.0 || dt > uLifeTime || alpha « 0.01) { 
// out of sight! 
gl Position = vec4(0.0, 0.0, -1000.0, 1.0); 


4 


else { 
// calculate new position 
vec3 accel - vec3(0.0, 0.0, -9.8); 
// apply a twist 
float PI - 3.14159265358979323846264; 


float theta = mod(100.0*length(aVel)*dt, 360.0)*PI/180.0; 


mat4 rot = mat4(vec4(cos(theta), sin(theta), 0.0, 0.0), 
vec4(-sin(theta), cos(theta), 0.0, 0.0), 
vec4(0.0, 0.0, 1.0, 0.0), 
vec4(0.0, 0.0, 0.0, 1.0)); 
// apply billboard matrix 
vec4 pos2 = bMatrix*rot*vec4(aVert, 1.0); 
// calculate position 


vec3 newPos = pos2.xyz + uPos + aVel*dt + 0.5*accel*dt*dt; 
// apply transformations 


gl Position = uPMatrix * uMVMatrix * vec4(newPos, 1.0); 
} 
// set color 
vCol = vec4(uColor.rgb, alpha); 
// set tex coords 
vTexCoord = aTexCoord; 


strFS = nau 
Zversion 330 core 


uniform sampler2D uSampler; 
in vec4 vCol; 

in vec2 vTexCoord; 

out vec4 fragColor; 


void main() { 
// get texture color 


vec4 texCol = texture(uSampler, vec2(vTexCoord.s, vTexCoord.t 
// multiply by set vertex color; use the vertex color alpr 
fragColor = vec4(texCol.rgb*vCol.rgb, vCol.a); 


# a simple camera class 
class Camera: 


"""helper class for viewing""" 

def | init (self, eye, center, up): 
self.r - 10.0 
self.theta = 0 
self.eye = numpy.array(eye, numpy.float32) 
self.center - numpy.array(center, numpy.float32) 
self.up - numpy.array(up, numpy.float32) 


def rotate(self): 

"""rotate eye by one step""" 

self.theta = (self.theta + 1) % 360 

# recalculate eye 

self.eye = self.center + numpy.array([ 
self.r*math.cos(math.radians(self.theta)), 
self.r*math.sin(math.radians(self.theta)), 
0.0], numpy.float32) 


# particle system class 
class ParticleSystem: 


# initialization 

def _ init (self, numP): 
# number of particles 
self.numP - numP 
# time variable 
self.t - 0.0 
self.lifeTime 
self.startPos 
# load texture 
self.texid - glutils.loadTexture('star.png') 
# create Shader 
self.program = glutils.loadShaders(strVS, strFS) 
glUseProgram(self.program) 


5.0 
numpy.array([0.0, 0.0, 0.5]) 


# set sampler 
texLoc - glGetUniformLocation(self.program, b'uTex") 
glUniformii(texLoc, 0) 
# uniforms 
self.timeU = glGetUniformLocation(self.program, b"uTime") 
self.lifeTimeU = glGetUniformLocation(self.program, b"uLifeTi 


self.pMatrixUniform - glGetUniformLocation(self.program, b'uP 


self.mvMatrixUniform = glGetUniformLocation(self.program, b"u 


self. 


bMatrixU = glGetUniformLocation(self.program, b"bMatrix" 


self.colorU = glGetUniformLocation(self.program, b"uColor") 


self. 


samplerU = glGetUniformLocation(self.program, b"uSampler 


self.posU = glGetUniformLocation(self.program, b"uPos") 


# attributes 


self.vertIndex = glGetAttribLocation(self.program, b"aVert") 


self.texIndex = glGetAttribLocation(self.program, b"aTexCoord 


self. 


timeOIndex = glGetAttribLocation(self.program, b"aTimeo" 


self.velIndex = glGetAttribLocation(self.program, b"aVel") 


# render flags 
self.enableBillboard - True 
self.disableDepthMask - True 
self.enableBlend - True 


# which texture to use 
self.useStarTexture - True 
# restart - first time 
self.restart(numP) 


# step 

def step(self): 
# increment time 
self.t += 0.01 


# restart particle system 
def restart(self, numP): 
# set number of particles 
self.numP - numP 


# time variables 
self.t = 0.0 
self.lifeTime = 5.0 


# color 


self.col® = numpy.array([random.random(), random.random(), 


random.random(), 1.0]) 


# create Vertex Arrays Object (VAO) 


self.vao = glGenVertexArrays(1) 
# bind VAO 
glBindVertexArray(self.vao) 


# create attribute arrays and vertex buffers: 


# vertices 
S = 0.2 
quadv = [ 

-S, S, 0.0, 

-S, -S, 0.0, 

S, S, 0.0, 

S, -S, 0.0, 

S, S, 0.0, 

-S, -S, 0.0 

] 
vertexData - numpy.array(numP*quadV, numpy.float32) 
self.vertexBuffer - glGenBuffers(1) 
glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 


glBufferData(GL ARRAY BUFFER, 4*len(vertexData), vertexData, 
GL STATIC DRAW) 


# texture coordinates 
quadT - 


OH HHOO 
OO0OO0OO’OOO 
OrFOrROoORT! 


tcData = numpy.array(numP*quadT, numpy.float32) 

self.tcBuffer = glGenBuffers(1) 

glBindBuffer(GL ARRAY BUFFER, self.tcBuffer) 
glBufferData(GL ARRAY BUFFER, 4*len(tcData), tcData, GL STATI 


# time lags 


timeData = numpy.repeat(0.005*numpy.arange(numP, dtype=numpy. 
4 


self.timeBuffer - glGenBuffers(1) 
glBindBuffer(GL ARRAY BUFFER, self.timeBuffer) 


glBufferData(GL ARRAY BUFFER, 4*len(timeData), timeData, 
GL STATIC DRAW) 
# velocites 


velocities = [] 
# cone angle 
coneAngle - math.radians(20.0) 
# set up particle velocities 
for i in range(numP): 
# inclination 
angleRatio = random.random() 
a = angleRatio*coneAngle 
# azimuth 
t = random.random()*(2.0*math.pi) 
# get veocity on sphere 
vx = math.sin(a)*math.cos(t) 
vy math.sin(a)*math.sin(t) 
vz = math.cos(a) 
# speed decreases with angle 
speed = 15.0*(1.0 - angleRatio*angleRatio) 
# add a set of calculated velocities 
velocities += 6*[speed*vx, speed*vy, speed*vz] 
# set up velocity vertex buffer 
self.velBuffer - glGenBuffers(1) 
glBindBuffer(GL ARRAY BUFFER, self.velBuffer) 
velData - numpy.array(velocities, numpy.float32) 


glBufferData(GL ARRAY BUFFER, 4*len(velData), velData, GL STA 
# enable arrays 
glEnableVertexAttribArray(self.vertIndex) 
glEnableVertexAttribArray(self.texIndex) 
glEnableVertexAttribArray(self.timeOIndex) 
glEnableVertexAttribArray(self.vellndex) 


# set buffers 
glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 


glVertexAttribPointer(self.vertIndex, 3, GL FLOAT, GL FALSE, 
glBindBuffer(GL ARRAY BUFFER, self.tcBuffer) 

glVertexAttribPointer(self.texIndex, 2, GL FLOAT, GL FALSE, 0 
glBindBuffer(GL ARRAY BUFFER, self.velBuffer) 

glVertexAttribPointer(self.velIndex, 3, GL FLOAT, GL FALSE, 0 
glBindBuffer(GL ARRAY BUFFER, self.timeBuffer) 


glVertexAttribPointer(self.timeOIndex, 1, GL FLOAT, GL FALSE, 


# unbind VAO 
glBindVertexArray(0) 


# render the particle system 

def render(self, pMatrix, mvMatrix, camera): 
# use shader 
glUseProgram(self.program) 


# set projection matrix 
glUniformMatrix4fv(self.pMatrixUniform, 1, GL_FALSE, pMatrix) 

# set modelview matrix 
glUniformMatrix4fv(self.mvMatrixUniform, 1, GL_FALSE, mvMatri 


# set up a billboard matrix to keep quad aligned to view dire 
if self.enableBillboard: 

= camera.eye - camera.center 

/= numpy.linalg.norm(N) 

camera.up 

- numpy.linalg.norm(U) 

numpy.cross(U, N) 

- numpy.cross(N, R) 

bMatrix = numpy.array([R[0O], U2[0], N[O], 0.0, 
R[1], U2[1], N[1], 6.6, 
R[2], U2[2], N[2], 6.6, 


cCcucczz 
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0.0, 0.0, 0.0, 1.0], numpy.float32) 


glUniformMatrix4fv(self.bMatrixU, 1, GL TRUE, bMatrix) 
else: 
# identity matrix 


bMatrix - numpy.array([1.0, 0.0, 0.0, 0.0, 
0.0, 1.0, 0.0, 0.0, 
0.0, 0.0, 1.0, 0.0 


了 


0.0, 0.0, 0.0, 1.0], numpy.float32) 


glUniformMatrix4fv(self.bMatrixU, 1, GL FALSE, bMatrix) 
# set start position 
gluniform3fv(self.posU, 1, self.startPos) 
# set time 
glUniformif(self.timeU, self.t) 
#set lifetime 
gluniformif(self.lifeTimeU, self.lifeTime) 
# set color 
glUniform4fv(self.colorU, 1, self.col®) 


# enable texture 

glActiveTexture(GL TEXTUREO) 
glBindTexture(GL TEXTURE 2D, self.texid) 
glUniformii(self.samplerU, 0) 


# turn depth mask off 
if self.disableDepthMask: 
glDepthMask(GL FALSE) 


# enable blending 

if self.enableBlend: 
glBlendFunc(GL SRC ALPHA, GL ONE) 
glEnable(GL BLEND) 


# bind VAO 

glBindVertexArray(self.vao) 

# draw 

glDrawArrays(GL TRIANGLES, 0, 6*self.numP) 
# unbind VAO 

glBindVertexArray(0) 


# disable blend 
if self.enableBlend: 
glDisable(GL_BLEND) 


# turn depth mask on 
if self.disableDepthMask: 
glDepthMask(GL_TRUE) 


# disable texture 
glBindTexture(GL_TEXTURE_2D, ®) 


IX EK ACER IN AAS, (HAT EE iB — 
ZT f FNAME AL S REN RV 


10.5 ”盒子 代码 


BE LEMMA NTE et SEF TER 
有 任何 灯光 的 红色 立方 体 就 行 了 。 





import sys, random, math 
import OpenGL 

from OpenGL.GL import * 
import numpy 

import glutils 


strVS = niu 
Zversion 330 core 


in vec3 aVert; 
uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 
out vec4 vCol; 


void main() { 
// apply transformations 


只 要 夯 一 个 没 


gl Position = uPMatrix * uMVMatrix * vec4(aVert, 1.0); 


// set color 
vCol = vec4(0.8, 0.0, 0.0, 1.0); 


strFS = "nN 
#version 330 core 


in vec4 vCol; 
out vec4 fragColor; 


void main() { 
// use vertex color 
fragColor = vCol; 


class Box: 
def _ init (self, side): 


self.side 


= side 


# load shaders 


self.program = glutils.loadShaders(strVS, 
glUseProgram(self.program) 


s = side/2 
vertices = 


.0 


strFS) 


# set up vertex array object (VAO) 

self.vao - glGenVertexArrays(1) 
glBindVertexArray(self.vao) 

# set up VBOs 

vertexData - numpy.array(vertices, numpy.float32) 
self.vertexBuffer - glGenBuffers(1) 
glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 


glBufferData(GL ARRAY BUFFER, 4*len(vertexData), vertexData, 
GL STATIC DRAW) 
#enable arrays 


self.vertIndex = glGetAttribLocation(self.program, "aVert") 
glEnableVertexAttribArray(self.vertIndex) 
# set buffers 
glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 


glVertexAttribPointer(self.vertIndex, 3, GL FLOAT, GL FALSE, 
# unbind VAO 
glBindVertexArray(0) 


def render(self, pMatrix, mvMatrix): 


# use shader 
glUseProgram(self.program) 


# set projection matrix 


glUniformMatrix4fv(glGetUniformLocation(self.program, 'uPMatr 
1, GL FALSE, pMatrix) 
# set modelview matrix 


glUniformMatrix4fv(glGetUniformLocation(self.program, 'uMVMat 
1, GL FALSE, mvMatrix) 
# bind VAO 
glBindVertexArray(self.vao) 
# draw 
glDrawArrays(GL TRIANGLES, 0, 36) 
# unbind VAO 
glBindVertexArray(0) 


盒子 的 代码 使 用 简单 的 顶点 和 片段 着 色 器 来 绘 
制 一 个 立方 体 。 这 里 使 用 的 概念 与 本 章 前 面 和 第 9 
章 中 讨论 的 相同 。 





10.6 Em 


该 项 目的 主 程序 源 文 件 是 psmain.py， 它 设置 了 
GLFW 窗 口 ， 处 理 了 键盘 事件 ， 并 创建 粒子 系统 。 
如 果 想 看 到 完整 的 程序 代码 ， 请 跳 到 10.7 节 。 








class PSMaker: 
"""GLFW Rendering window class for Particle System""" 
def _ init (self): 
@ self.camera = Camera([15.0, 0.0, 2.5], 
[0.0, 0.0, 2.5], 
[0.0, 0.0, 1.0]) 
self.aspect - 1.0 
self.numP - 300 
self.t = 0 
# flag to rotate camera view 
self.rotate - True 


# save current working directory 
cwd = os.getcwd() 


# initialize glfw; this changes cwd 
eo glfw.glfwInit() 


# restore cwd 
os.chdir(cwd) 


# version hints 
glfw.glfwwindowHint(glfw.GLFW CONTEXT VERSION MAJOR, 3) 
glfw.glfwwindowHint(glfw.GLFW CONTEXT VERSION MINOR, 3) 
glfw.glfwwindowHint(glfw.GLFW OPENGL FORWARD COMPAT, GL TRUE) 

glfw.glfwwindowHint(glfw.GLFW OPENGL PROFILE, 

glfw.GLFW OPENGL CORE PROFILE) 


# make a window 


self.width, self.height = 640, 480 
self.aspect - self.width/float(self.height) 


self.win = glfw.glfwCreatewindow(self.width, self.height, 
b"Particle System") 


# make context current 
glfw.glfwMakeContextCurrent(self.win) 


# initialize GL 

glViewport(0, ©, self.width, self.height) 
glEnable(GL_DEPTH_TEST) 

glClearColor (0.2, 0.2, 0.2,1.0) 


# set window callbacks 
glfw.glfwSetMouseButtonCallback(self.win, self.onMouseButton) 

glfw.glfwSetKeyCallback(self.win, self.onKeyboard) 

glfw.glfwSetwindowSizeCallback(self.win, self.onSize) 


# create 3D 


e self.psys - ParticleSystem(self.numP) 
o self.box = Box(1.0) 

# exit flag 
® self.exitNow = False 


类 PSMaker 创 建 粒 子 系统 ， 处 理 GLFW 窗 口 ， 
并 负责 演 染 噶 果 和 表示 其 源头 的 盒子 。 在 @ 行 ， 创 
妹 一 个 Camera 对 象 ， 它 可 以 用 于 在 OpenGL 中 设置 
观看 参数 。 从 灸 行 开 始 的 代码 块 设置 了 GLFW 窗 
口 ， 在 信行 ， 创 建 ParticleSystem 对 象 ， 在 人 @ 行 ， 创 
建 Box 对 象 。 在 @ 行 ， 是 在 主 GLFW 演 染 循环 中 使 
用 的 退出 标志 ， 接 下 来 你 会 看 到 。 


10.6.1 每 步 更 新 这 些 粒 子 





通过 在 主 程序 循环 中 更 新 一 个 时 间 变 量 ， 我 们 
创建 了 动画 。 主 程序 循环 进而 义 更 新 顶点 看 色 占 中 
的 时 间 变 量 。 用 这 个 新 时 间 值 ， 计 算 并 泻 染 下 一 
帧 ， 从 而 更 新 这 些 粒子 的 位 置 。 看 色 融 计算 粒子 的 
新 胃癌， 也 让 和 它们 旋转 。 此 外 ， 痢 色 堪 计算 alpha 
值 ， 它 是 时 间 变 量 的 函数 ， 将 用 于 最 后 的 泻 染 ， 实 
现 火 化 逐渐 淡出 。 


step() 方 法 为 每 个 时 间 步 骤 更 新 粒子 系统 。 





def step(self): 
# increment time 
self.t += 10 
self.psys.step() 
# rotate eye 
if self.rotate: 
e self.camera.rotate() 
# restart every 5 seconds 
if not int(self.t) % 5000: 
o self.psys.restart(self.numP) 


oe 





#07, SUN Ae, TUENAHANMER 
流逝 的 时 间 。 在 灸 行 ， 调 用 ParticleSystem 的 step() 方 
法 ， 这 样 它 可 以 目 行 更 新 。 如 果 设 置 了 标志 ， 职 在 
个 行 旋转 相机 。 每 5 秒 钟 〈5000 毫 秒 ) PT AA 
在 人 @ 行 重新 月 动 . 


10.6.2 ”键盘 处 理 程 序 
现在 ， 来 看 看 GLFW 窗 口 的 键盘 处 理 程 序 。 





@ def onKeyboard(self, win, key, scancode, action, mods): 


#pr 
if 


self.psys. 


self.psys. 


self.psys. 


int 'keyboard: ', win, key, scancode, action, mods 
action == glfw.GLFW_PRESS: 
# ESC to quit 
if key == glfw.GLFW_KEY_ESCAPE: 
self.exitNow = True 
elif key == glfw.GLFW_KEY_R: 
self.rotate = not self.rotate 
elif key == glfw.GLFW_KEY_B: 
# toggle billboarding 


enableBillboard = not self.psys.enableBillboard 
elif key == glfw.GLFW_KEY_D: 
# toggle depth mask 


disableDepthMask = not self.psys.disableDepthMask 
elif key == glfw.GLFW_KEY_T: 
# toggle transparency 


enableBlend = not self.psys.enableBlend 


曲 行 的 键盘 处 理 程序 ， 主 要 在 关闭 用 于 绘制 粒 





子 系统 的 各 种 演 染 撤 巧 时 ， 让 你 很 容易 看 到 所 及 生 
的 事情 。 这 段 代 码 让 你 切换 旋转 、 公 告 板 、 深 度 遍 
Té RI BH FE 


10.6.3 ”管理 主 程序 循环 


使 用 GLFW 时 ， 必 须 管 理 自己 的 主 程序 循环 。 








下 和 面 是 这 个 程序 中 使 用 的 循环 : 


def run(self): 
# initializer timer 
glfw.SetTime(0) 


t = 


while not 


0.0 


glfw.glfwwindowShouldClose(self.win) and not self. 
# update every x seconds 


(2) currT = glfw.glfwGetTime() 
if currT - t > 0.01: 
# update time 
t = currT 
# clear 
glClear(GL COLOR BUFFER BIT | GL DEPTH BUFFER BIT) 


# render 


pMatrix - glutils.perspective(100.0, self.aspect, 0.1, 100.0) 
# modelview matrix 


mvMatrix - glutils.lookAt(self.camera.eye, self.camera.center 
self.camera.up) 


# draw nontransparent object first 


e self.box.render(pMatrix, mvMatrix) 
# render 

© 

self.psys.render(pMatrix, mvMatrix, self.camera) 
4 step 

® self.step() 


glfw.glfwSwapBuffers(self.win) 
# poll for and process events 
glfw.glfwPollEvents() 

# end 

glfw.glfwTerminate() 





这 上 段 代 人 码 与 第 9 章 中 使 用 的 循环 几乎 是 相同 
的 。 在 @ 行 ， 如 果 exit 标 志 已 设置 或 GLFW 窗 口 关 
闭 ，while 循 环 就 退出 。 在 信行 和 后 面 一 行 ， 使 用 
GLEFW 计 时 器 ， 仅 当时 间 流 逝 一 定量 〈0.1 秒 ) NT 
进行 演 染 ， 从 而 控制 演 染 的 帧 速率 。 在 候 行 绘制 盒 
子 ， 在 @ 行 绘制 粒子 系统 ( 泻 染 的 顺序 很 重要 : xm 





明 物 体 总 是 最 后 绘制 ， 这 样 它 们 能 够 与 场景 中 不 透 
明 的 物体 正确 地 混合 和 深度 缓冲 ) o EOT, PX} 
当前 时 间 步 又 更 新 粒子 系统 。 


10.7 完整 主 程序 代码 


下 面 是 psmain.py 的 完整 代码 。 也 可 以 在 
https://github.com/electronut/pp/tree/master/particle- 
systemy/ 找 到 这 段 代 码 。 


import sys, os, math, numpy 

import OpenGL 

from OpenGL.GL import * 

import numpy 

from ps import ParticleSystem, Camera 
from box import Box 

import glutils 

import glfw 


class PSMaker: 
"""GLFW Rendering window class for Particle System""" 
def _ init (self): 
self.camera - Camera([15.0, 0.0, 2.5], 
[0.0, 0.0, 2.5], 
[0.0, 0.0, 1.0]) 
self.aspect - 1.0 
self.numP - 300 
self.t = © 
# flag to rotate camera view 
self.rotate = True 


# save current working directory 
cwd = os.getcwd() 


# initialize glfw; this changes cwd 
glfw.glfwInit() 


# restore cwd 
os.chdir(cwd) 


# version hints 


glfw.glfwwindowHint(glfw.GLFW CONTEXT VERSION MAJOR, 3) 
glfw.glfwwindowHint(glfw.GLFW CONTEXT VERSION MINOR, 3) 


glfw.glfwwindowHint(glfw.GLFW OPENGL FORWARD COMPAT, GL. TRUE) 
glfw.glfwwindowHint(glfw.GLFW OPENGL. PROFILE, 
glfw.GLFW OPENGL CORE PROFILE) 


# make a window 
self.width, self.height - 640, 480 
self.aspect - self.width/float(self.height) 


self.win - glfw.glfwCreatewindow(self.width, self.height, 
b"Particle System") 
# make context current 
glfw.glfwMakeContextCurrent(self.win) 


# initialize GL 

glViewport(0, ©, self.width, self.height) 
glEnable(GL DEPTH TEST) 

glClearColor(0.2, 0.2, 0.2,1.0) 


# set window callbacks 


glfw.glfwSetMouseButtonCallback(self.win, self.onMouseButton) 
glfw.glfwSetKeyCallback(self.win, self.onKeyboard) 
glfw.glfwSetWindowSizeCallback(self.win, self.onSize) 


4 create 3D 
self.psys - ParticleSystem(self.numP) 
self.box - Box(1.0) 


# exit flag 
self.exitNow - False 


def onMouseButton(self, win, button, action, mods): 
#print 'mouse button: ', win, button, action, mods 
pass 


def onKeyboard(self, win, key, scancode, action, mods): 
#print 'keyboard: ', win, key, scancode, action, mods 
if action -- glfw.GLFW PRESS: 
# ESC to quit 
if key -- glfw.GLFW KEY ESCAPE: 
self.exitNow - True 
elif key -- glfw.GLFW KEY R: 
self.rotate - not self.rotate 


elif key -- glfw.GLFW KEY B: 
# toggle billboarding 


self.psys.enableBillboard - not self.psys.enableBillboard 
elif key -- glfw.GLFW KEY D: 
# toggle depth mask 


self.psys.disableDepthMask - not self.psys.disableDepthMask 
elif key -- glfw.GLFW KEY T: 
# toggle transparency 


self.psys.enableBlend - not self.psys.enableBlend 


def onSize(self, win, width, height): 
#print 'onsize: ', win, width, height 
self.width - width 
self.height height 
self.aspect width/float(height) 
glViewport(0, ©, self.width, self.height) 


def step(self): 

# increment time 

self.t += 10 

self.psys.step() 

4 rotate eye 

if self.rotate: 
self.camera.rotate() 

# restart every 5 seconds 

if not int(self.t) % 5000: 
self.psys.restart(self.numP) 


def run(self): 
# initializer timer 
glfw.glfwSetTime(®) 
t = 0.0 


while not glfw.glfwWindowShouldClose(self.win) and not self.e 
# update every x seconds 
currT = glfw.glfwGetTime() 
if currT - t » 0.01: 
# update time 
t - currT 


# clear 
glClear(GL COLOR BUFFER BIT | GL DEPTH BUFFER BIT) 


# render 


pMatrix = glutils.perspective(100.0, self.aspect, 0.1, 100.0) 
# modelview matrix 


mvMatrix - glutils.lookAt(self.camera.eye, self.camera.center 
self.camera.up) 


# draw nontransparent object first 
self.box.render(pMatrix, mvMatrix) 


# render 
self.psys.render(pMatrix, mvMatrix, self.camera) 


# step 
self.step() 


glfw.glfwSwapBuffers(self.win) 
# poll for and process events 
glfw.glfwPollEvents() 

# end 

glfw.glfwTerminate() 


# main() function 

def main(): 
# use sys.argv if needed 
print('starting particle system...') 
prog - PSMaker() 
prog.run() 


# call main 
if _name__ == ' main ': 
main() 


10.8 ”运行 程序 


要 运行 该 项 目 ， 请 输入 以 下 命令 : 


$ python3 psmain. py 


本 章 开 始 的 图 10-1 展 示 了 输出 。 


10.9 ”小 结 


Zk3& FA Python#llOpenGL Gi] E f. Wig Hi A 
统 。 我 们 学 习 了 创建 粒子 系统 的 数学 模型 ， 建 并 了 
着 色 需 程序 ， 并 利用 了 一 些 OpenGL 技 巧 ， 以 通 真 
的 方式 演 染 粒子 。 





10.10 ”实验 


下 面 有 一 些 想 法 ， 可 以 用 更 多 的 方式 来 试验 粒 
子 系统 动画 。 


1. 如 果 每 个 粒子 的 喷射 没有 时 间 延 迟 ， 看 看 
情况 如 何 。 


2， 让 喷 景 中 的 粒子 在 喷射 时 逐渐 变 大 《〈 提 
zh: MUTIEREND UND 。 


3. 这 些 代 码 让 每 个 粒子 遵循 完美 的 抛物 线 ， 
因为 它 从 喷 果 喷 出 。 请 为 粒子 的 路 径 增加 一 些 随 机 
性 (提示 : 研究 GLSL 的 noise(0) 方 法 ， 你 可 以 在 顶点 
着 色 器 中 使 用 ) 。 


4. 在 顺 果 中 的 粒子 遵循 抛物 线 轨 迹 ， 上 升 ， 
然后 由 于 重力 作用 下 落 。 你 能 让 它们 跌落 到 地 板 时 
反弹 吗 ? 可 能 需要 增加 粒子 的 寿命 来 实现 〈 提 示 : 
地 板 位 于 z = 0.0 处 。 在 顶点 看 色 需 中 ， 当 粒子 接近 
地 面 时 ， 反 转速 度 的 z 分 量 ) 。 
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MRI 和 CT 扫描 这 样 的 诊断 过 程 会 创建 体 数 
据 ， 它 由 一 组 二 维 图 像 来 表示 通过 三 维 物 体 的 截 
面 。 体 绘制 是 一 种 计算 机 图 形 技术 ， 利 用 这 种 类 型 
的 体 数 据 来 构造 三 维 图 像 。 虽 然 体 绘制 通常 用 于 分 
析 医 学 扫描 ， 但 也 可 以 用 于 地 质 、 考 古 和 分 子 生物 
学 等 学 科 ， 生 成 三 维 科 学 可 视 化 效果 。 

由 MRI 和 CT 扫描 记录 的 数据 通常 采取 
NxxNyxNz 的 三 维 网 格 形 式 ， 或 Nz 个 二 维 “ 切 厂 ”， 
其 中 每 个 切片 是 大 小 为 NxxNy 的 图 像 。 体 绘制 算法 
采用 茶 种 类 型 的 透明 上 度 ， 来 展示 采集 切片 数据 ， 并 
采用 各 种 技术 来 强调 被 演 染 物体 中 关注 的 部 分 。 


本 项 目 将 探讨 名 为 “ 体 光 线 投 映 (volume ray 
casting) ”的 体 绘 制 算法 ， 它 充分 利用 图 形 处 理 单元 
(GPU) ， 用 OpenGL 着 色 语 言 (GLSL) MER 
来 进行 计算 。 代 码 针 对 屏幕 上 的 每 个 像素 执行 ， 并 
利用 了 GPU， 其 目的 是 有 效 地 进行 并 行 计 算 。 利 用 
二 维 图 像 文 件 夹 中 包含 的 三 维 数据 集 切 片 ， 用 体 光 
线 投射 算法 ， 构 建 体 这 染 网 像 。 我 们 还 会 实现 一 种 
方法 ， 显 示 在 x、y、z 方 同上 的 二 维 切 片 数 据 ， 以 
便 用 户 可 以 通过 第 头 键 来 深 动 切 厂 。 键 盘 命 令 让 用 

户 在 三 维 泻 染 和 二 维 切 片 之 间 切 换 。 


下 面 是 本 项 目 涉及 的 一 些 主题 : 











。 用 GLSL 进 行 GPU 计 算 ; 

。 创 建 顶 点 和 片段 着 色 器 ; 

。 表 示 三 维 立 体 数 据 ， 并 使 用 体 光 线 投身 算法; 
。 用 numpy 数 组 表示 三 维 变换 矩阵 。 


11.1 工作 原理 





有 许多 方式 来 泻 染 三 维 数据 集 。 本 项 目 将 使 用 
体 光 线 投 冉 的 方法 ， 它 是 基于 图 像 的 泻 染 技术 ， 从 
二 维 切 厂 逐 个 像素 地 生成 最 终 图 像 的 。 与 此 形成 对 
比 的 是 ， 典 型 的 三 维 泻 染 方法 是 基于 对 象 的 : 它们 
开始 用 三 维 对 象 表示 ， 然 后 应 用 变换 来 生成 投射 的 
FEAR HARES o 


在 本 项 目 用 到 的 体 光 线 投 射 方法 中 ， 对 于 输出 
图 像 中 的 每 个 像素 ， 一 束 光 线 射 入 离散 的 三 维 体 数 
Toe, FOL AANA AKIE. MERT LA 
体 ， 数 据 以 一 定 的 间隔 采 样 ， 样 本 被 组 合 〈 或 “ 合 
成 ”) 来 计算 最 终 图 像 的 颜色 值 或 强度 〈 你 可 以 认 
为 这 个 过 程 类 似 于 堆 野 一 些 透明 胶片 ， 将 它们 放 在 
强 光 下 ， 看 到 所 有 的 胶片 组 合 的 效果 ) 。 


体 光 线 投射 演 染 的 实现 通 第 使 用 一 些 技术 ， 如 
采用 梯度 改进 最 终 演 染 的 外 观 ， 用 过 滤 来 分 离 三 维 
特征 ， 用 空间 优化 技术 以 提高 速度 ， 但 我 们 只 实现 
基本 的 光线 投射 算法 ， 通 过 xx 射线 投射 合成 最 终 图 
像 〈 我 的 实现 ， 主 要 基于 2003 年 Kruger 和 
Westermann 在 该 主题 上 的 开创 性 论文 出) 。 























11.1.1 数据 格式 


本 项 目 将 使 用 来 自 斯 坦 福 体 数据 档案 
(Stanford Volume Data Archive) 的 三 维 扫描 医学 
数据 包 。 该 档案 提供 了 一 些 极 好 的 三 维 医学 数据 集 
的 TIFF 图 像 (包括 CT 和 MRI) ， 每 张 图 像 表示 该 物 
体 的 每 个 二 维 横 截面 。 我 们 将 读 入 文件 夹 中 的 这 些 
图 像 ， 作 为 OpenGL 三 维 纹理 。 这 有 点 像 堆 闭 一 系 
列 二 维 图 像 ， 形 成 一 个 长 方 体 ， 如 图 11-1 所 示 。 


回顾 第 9 章 ，OpenGL 中 的 二 维 纹理 是 由 一 个 二 
维 坐 标 〈s，t) 定位 的 。 类 似 地 ， 三 维 纹理 用 三 维 
纹理 坐标 定位 ， 形 如 (s，t，p)。 如 你 所 见 ， 将 体 
数据 保存 为 三 维 纹理 ， 可 以 让 你 快速 访问 数据 ， 并 
提供 光线 投射 方案 所 需 的 插值 。 








三 维 物体 





图 11-1 ”从 三 维 切片 建立 三 维 立 体 数 据 
11.1.2 ”生成 光线 


该 项 目的 目标 是 生成 三 维 体 数 据 的 透视 投影 ， 
如 图 11-2 所 示 。 


图 11-2 展 示 了 OpenGL 视 锥 ， 这 在 第 9 章 讨 论 
过 。 具 体 来 说 ， 它 展示 了 来 自 眼 睛 的 光线 如 何 从 近 
裁 筋 平面 进入 此 锥 体 ， 通 过 立方 状 的 物体 〈 其 中 包 
T Xs). SPM Je i CET BE. 








ME 
立方 体 的 光线 出 品 


^ 


TANPE 
立方 体 的 光线 入 口 








近 坊 剪 平面 (输出 窗口 ) 


眼睛 
图 11-2 三 维 体 数据 透视 投影 


为 了 实现 光线 投射 ， 需 要 生成 进入 物体 的 光 
线 。 对 于 图 11-2 所 示 的 输出 窗口 中 的 每 个 像素 ， 生 








成 一 个 同 量 R， 它 进入 我 们 作为 单位 立方 体 的 物体 
中 (我 称 之 为 彩色 立方 体 ) ， 该 立方体 在 坐标 
(0，0，0) 和 (1，1，1) 之 间 。 这 个 立方 体 中 的 
每 个 点 的 颜色 ， 其 RGB 值 等 于 它 的 三 维 坐 标 。 原 点 
颜色 为 (0，0，0) ， 即 黑色 。 (1 0, 0) Hei 
色 ， 与 原点 相对 的 顶点 颜色 为 (1，1，1)〉， 即 白 
色 。 图 11-3 展 示 了 这 个 立方 体 。 




















图 11-3 ”彩色 立方 体 


在 OpenGL 中 ， 颜 色 可 以 表示 为 一 串 8 位 无 符号 值 (r, g, b)， 其 中 
r、g 和 b 的 范围 是 [0，255]。 它 也 可 以 表示 为 32 位 的 浮 点 值 (, g, b), 
其 中 r、g 和 b 的 范围 是 [0.0，1.0]。 这 些 表示 是 等 效 的 。 例 如 ， 前 一 
种 的 红色 (255, 0, 0) 等 同 于 后 一 种 的 (1.0，0.0，0.0) 。 


要 绘制 立方 体 ， 先 用 OpenGL 图 元 
GL_TRIANGLES 绘 制 它 的 6 个 面 。 然 后 确定 每 个 顶 
点 的 其 色 ， 并 在 多 边 形 光栅 化 、 生 成 顶点 之 间 的 闫 
色 时 ， 利 用 OpenGL 提 供 的 插值 。 例 如 ， 如 图 11- 
A (A) 展示 了 立方 体 的 三 个 正面 。 图 11-4 (B) 将 
OpenGL 设 置 为 剔除 正面 ， 绘 制 了 立方 体 的 背面 。 


如 果 从 图 11-4 (B) 中 减 去 图 11-4 CAO "B 
色 ， 即 从 (r, g, b)back 减 去 (r, g, b)front， 实 际 上 计算 
了 一 组 同 量 ， 从 立方 体 的 正面 指 癌 背面 ， 因 为 该 并 
方 体 上 每 点 的 颜色 (r，g，Db) 与 三 维 坐 标 相 同 。 图 11- 
4 (C) 展示 了 结果 (为 了 展示 ， 负 值 已 经 翻转 为 
正 ， 因 为 负数 不 能 直接 显示 为 颜色 ) 。 读 取 一 个 像 
素 的 颜色 值 ([(， g, b)， 如 图 11-4(C〉 所 示 ， 得 到 
Crx, ry, IZ) 坐标 ， 即 在 这 一 点 罕 透 物体 的 光线 。 


有 了 投射 光线 后 ， 将 它们 演 染 成 一 张 图 或 二 维 
纹理 ， 稍 后 与 OpenGL 的 帧 缓冲 对 象 (FBO) 功能 
一 起 使 用 。 产 生 这 个 纹理 之 后 ， 可 以 在 实现 光线 投 
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图 11-4 用 于 计算 光线 的 颜色 立方 体 
GPU 中 的 光线 投射 


为 了 实现 光线 投射 算法 ， 首 先 将 彩色 立方 体 的 
背面 绘制 到 FBO。 接 着 ， 将 正面 绘制 在 屏 帮 上 。 光 
ZRBC SIZ EY EBB at RECARE as BEAT 
APARER, ERODE BES RAR TET © FEBS 
计算 是 用 颜色 立方 体 的 背面 闫 色 减 去 传 入 厂 段 的 正 
面 闫 色 ， 背 面 颜色 是 从 纹理 中 读 取 的 。 然 后 将 计算 
好 的 光线 囚 加 ， 并 利用 看 色 虱 中 可 用 的 三 维 体 纹理 
数据 ， 计 算 最 终 的 像 系 值 。 


育 面 别 除 








在 OpenGL 中 ， 如 果 要 画 四 边 形 这 样 的 图 元 ， 指 定 顶 点 的 顺序 
很 重要 。 默 认 情 况 下 ，OpenGL 假 定 用 GL_CCW RER) 的 顺 
序 。 对 于 逆 时 针 顺 序 的 图 元 ， 法 矢量 将 指向 多 边 形 的 “外 面 >。 如 果 
试图 绘制 封闭 区 域 的 几何 图 形 ， 如 立方 体 ， 这 就 有 关系 了 。 为 了 优 
化 泻 染 ， 你 不 用 绘制 看 不 见 的 面 ， 只 要 打开 OpenGL 的 “背面 剔除 
(back-face culling) ", 计算 观看 方 同 同 量 与 多 边 形 法 同 量 的 点 
积 。 对 于 朝 同 背面 的 多 边 形 ， 点 积 是 负 的 ， 这 些 面 可 以 丢弃 。 
OpenGL 也 提供 了 一 种 简单 的 方法 来 做 相反 的 事 ， 即 正面 吻 除 ， 这 
就 是 我 们 在 算法 要 用 到 的 。 


显示 二 维 切 厂 


除了 三 维 演 染 ， 也 可 以 显示 数据 的 二 维 切 片 ， 
做 法 是 从 三 维 数据 中 提取 垂直 于 x 轴 、y 轴 或 z 轴 的 
二 维 模 截面 ， 并 将 它 作 为 一 个 四 边 形 的 纹理 。 因 为 
我 们 将 物体 保存 为 三 维 纹理 ， 所 以 很 容易 通过 指定 
纹理 坐标 Cs, t, p) FPA TIUS. OpenGL E 
的 纹理 插值 可 以 给 出 三 维 纹理 内 任意 位 置 的 纹理 
值 。 


11.1.3 57s OpenGL f HO 


像 其 他 OpenGL 项 目 一 样 ， 本 项 目 用 GLFW 库 
来 显示 OpenGL 窗 口 。 我 们 用 处 理 程序 来 绘制 ， 啊 
应 调整 窗口 大 小 和 键盘 事件 。 我 们 将 利用 键盘 事件 
FES AMY) ie eZ AR, DAR Se it = aE 
数据 的 旋转 和 切片 。 











11.2 Prom xA 


我 们 用 PyOpenGL 进 行 演 染 ， 它 是 流行 的 
OpenGL 的 Python 绑 定 。 我 们 还 用 numpy 数 组 来 表示 
三 维 坐 标 和 变换 窍 阵 。 


11.3 项 目 代 码 概 述 


我 们 首先 从 体 数据 生成 三 维 纹理 ， 数 据 是 从 文 
PREAH © BE ROR, BRAT TET RON, 
于 生成 从 眼睛 指 癌 物体 的 光线 ， 这 古 实 现 体 光线 投 
出 算法 的 关键 概 仿 。 我 们 将 分 析 如 何 定 义 立 方 体 的 
几 体 形状 ， 如 何 绘制 该 立方 体 的 背面 和 正面 。 然 
后 ， 我 们 将 探索 体积 光线 投射 算法 ， 以 及 相关 的 顶 
RA BEER a, RITA MT REAL 
据 的 二 维 切 片 。 


该 项 目 有 7 个 Python 文件 : 


glutils.py 包 含 针 对 OpenGL 着 色 器 、 转 换 和 其 
他 相关 工具 方法 ; 


makedata.py 包 含 创 建 测试 体 数 据 的 工具 方法 ; 
raycast.py 3:3 Y RayCastRender2$, H T2652 











BON 


raycube.py 实 现 了 RayCastRender 中 使 用 的 
RayCube 类 ; 


slicerender.py 实 现 了 SliceRender 类 ， 用 于 体 数 
据 的 二 维 切 所 ; 


volreader.py 包 含 一 个 工具 方法 ， 读 取 体 数据 作 
为 OpenGL 的 三 维 纹理 ， 


volrender.py E. £ H T & $&GLEW ff O PE HERR 
的 主要 方法 。 

除了 两 个 文件 之 外 ， 本 章 将 介绍 所 有 这 些 文 
件 。 文 件 makedata.py 和 本 章 中 的 其 他 项 目 文 件 一 起 
放 在 
https://github.com/electronut/pp/tree/master/volrender/. 
文件 glutils.py 可 以 从 
https://github.com/electronut/pp/tree/master/common/ 


下 载 。 
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如 下 面 代码 所 示 。 要 查看 volreader.py 的 完整 代码 ， 
请 直接 跳 到 11.5 节 。 


def loadVolume(dirName): 


e 


e 


"""read volume from directory as a 3D texture""" 
# list images in directory 

files - sorted(os.listdir(dirName)) 
print('loading images from: %s' 96 dirName) 
imgDataList = [] 

count = 0 

width, height = 0, 0 

for file in files: 


file path = os.path.abspath(os.path.join(dirName, file) ) 


e 


© 


try: 
# read image 
img = Image.open(file_path) 
imgData = np.array(img.getdata(), np.uint8) 


# check if all images are of the same size 
if count is 0: 
width, height - img.size[0], img.size[1] 
imgDataList.append(imgData) 
else: 


if (width, height) -- (img.size[0], img.size[1]): 


imgDataList.append(imgData) 

else: 

print('mismatch') 

raise RunTimeError("image size mismatch") 
count += 1 
#print img.size 

except: 

# skip 
print('Invalid image: %s' 96 file path) 


# load image data into single array 
depth = count 
Q data = np.concatenate(imgDataList) 
print('volume data dims: %d 96d %d' % (width, height, depth)) 
# load data into 3D texture 
@ texture = glGenTextures(1) 
glPixelStorei(GL UNPACK ALIGNMENT, 1) 
glBindTexture(GL TEXTURE 3D, texture) 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE WRAP S, GL CLAMP TO 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE WRAP T, GL CLAMP TO 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE WRAP R, GL CLAMP TO 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE MAG FILTER, GL LINE 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE MIN FILTER, GL LINE 
Q glTexlImage3D(GL TEXTURE 3D, ©, GL RED, 
width, height, depth, 0, 
GL RED, GL UNSIGNED BYTE, data) 


# return texture 
Q return (texture, width, height, depth) 


loadVolumeO) 方 法 先 用 os 模块 中 的 listdirO) 方 
法 ， 列 出 了 给 定 目 录 中 的 文件 @。 然 后 加 载 图 像 文 
件 本 身 。 在 信行 ， 利 用 os.path.abspath() 和 
os.path.join()， 将 文件 名 添加 到 目录 ， 从 而 不 必 处 
理 相 对 文件 路 符 和 操作 系统 (OS) 特定 的 路 径 约定 
(Python 代码 中 经 第 可 以 看 到 这 个 有 用 的 习惯 
法 ， 用 于 过 有 历 文 件 和 目录 ) 。 


在 个 行 ， 利 用 Python 网 像 库 〈PIL ) 中 的 Image 
将 图 像 加 载 到 8 位 的 numpy 数 组 。 如 果 指 定 的 文 











件 不 是 图 像 或 图 像 加 载 失 败 ， 则 抛 出 一 个 异种 ， 我 
们 捕获 它 并 打印 错误 。 


因为 要 将 这 些 图 像 加 载 成 为 三 维 纹理 ， 所 以 需 
要 确保 它们 都 具有 相同 的 尺寸 〈 宽 x 高 ) EO 
和 合 行 确认 。 保 存 第 一 张 图 像 的 尺寸 ， 并 与 新 传 入 
的 图 像 进 行 比较 。 所 有 图 像 加 载 为 单独 的 数组 后 ， 
利用 numpy 的 concatenate() 方 法 ， 将 这 些 数组 连接 起 
来 ， 创 建 包 含 三 维 数据 的 最 终 数组 @. 


在 人 @ 行 和 接 下 来 几 行 中 ， 创 建 了 OpenGL 纹 
理 ， 并 针对 过 滤 和 拆 包 设置 了 参数 。 然 后， 在 人 @ 
行 ， 将 三 维 数据 数组 加 载 为 OpenGL 纹 理 。 这 里 使 
用 的 格式 是 GL_ RED， 数 据 格 式 是 
GL_UNSIGNED_BYTE， 因 为 在 数据 中 ， 我 们 只 有 
一 个 8 位 值 与 每 个 像素 相关 联 。 


纹理 的 尺寸 。 


15 ”完整 的 三 维 纹理 代码 


下 面 是 完整 的 代码 清单 。 可 以 在 
https://github.com/electronut/pp/tree/master/volrender/ 
找到 volreader.py 文 件 。 


import os 
import numpy as np 
from PIL import Image 


import OpenGL 
from OpenGL.GL import * 


from scipy import misc 


def loadVolume(dirName): 
"""read volume from directory as a 3D texture""" 
# list images in directory 
files - sorted(os.listdir(dirName)) 
print('loading images from: %s' 96 dirName) 
imgDataList = [] 
count = 0 
width, height = 0, 0 
for file in files: 


file path = os.path.abspath(os.path.join(dirName, file) ) 
try: 
# read image 
img = Image.open(file_path) 
imgData = np.array(img.getdata(), np.uint8) 


# check if all are of the same size 

if count is 0: 
width, height = img.size[0], img.size[1] 
imgDataList.append(imgData) 

else: 


if (width, height) -- (img.size[0], img.size[1]): 


imgDataList.append(imgData) 
else: 
print('mismatch' ) 
raise RunTimeError("image size mismatch" ) 
count += 1 
#print img.size 
except: 
# skip 
print('Invalid image: %s' % file_path) 


# load image data into single array 
depth = count 
data = np.concatenate(imgDataList ) 


print('volume data dims: %d 96d %d' % (width, height, depth) ) 


# load data into 3D texture 

texture = glGenTextures(1) 
glPixelStorei(GL UNPACK ALIGNMENT, 1) 
glBindTexture(GL TEXTURE 3D, texture) 


glTexParameterf(GL TEXTURE 3D, GL TEXTURE WRAP S, GL CLAMP TO 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE WRAP T, GL CLAMP TO 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE WRAP R, GL CLAMP TO 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE MAG FILTER, GL LINE 


glTexParameterf(GL TEXTURE 3D, GL TEXTURE MIN FILTER, GL LINE 
glTexImage3D(GL TEXTURE 3D, 0, GL RED, 
width, height, depth, 0, 
GL RED, GL UNSIGNED BYTE, data) 
Zreturn texture 
return (texture, width, height, depth) 


# load texture 

def loadTexture(filename): 
img - Image.open(filename) 
img data - np.array(list(img.getdata()), 'B') 
texture - glGenTextures(1) 
glPixelStorei(GL UNPACK ALIGNMENT, 1) 
glBindTexture(GL TEXTURE 2D, texture) 


glTexParameterf(GL TEXTURE 2D, GL TEXTURE WRAP S, GL CLAMP TO 


glTexParameterf(GL TEXTURE 2D, GL TEXTURE WRAP T, GL CLAMP TO 


glTexParameterf(GL TEXTURE 2D, GL TEXTURE MAG FILTER, GL LINE 
glTexParameterf(GL TEXTURE 2D, GL TEXTURE MIN FILTER, GL LINE 
glTexImage2D(GL TEXTURE 2D, ©, GL RGBA, img.size[0], img.size 


©, GL RGBA, GL UNSIGNED BYTE, img data) 
return texture 
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生成 光线 的 代码 封装 在 RayCube 类 中 。 该 类 负 
ne 乡 色 立方 体 ， 它 有 一 些 方法 将 立方 体 的 背面 
绘制 到 FBO 或 纹理 中 ， 并 将 立方 体 的 正面 绘制 到 屏 
EL. 要 查看 完整 的 raycube.py 代 码 ， 请 直接 跳 到 
11:7 35 


首先 ， 定 义 这 个 类 使 用 的 痢 色 需 : 








e strvs = "un" 
Zversion 330 core 


layout(location 
layout(location 


= 1) in vec3 cubePos; 
= 2) in vec3 cubeCol; 
uniform mat4 uMVMatrix; 

uniform mat4 uPMatrix; 

out vec4 vColor; 


void main() 


// set back-face color 
vColor = vec4(cubeCol.rgb, 1.0); 


// transformed position 
vec4 newPos = vec4(cubePos.xyz, 1.0); 


// set position 
gl Position - uPMatrix * uMVMatrix * newPos; 


j 


(2) strFS 一 "un" 


Zversion 330 core 


in vec4 vColor; 
out vec4 fragColor; 


void main() 


fragColor - vColor; 





在 @ 行 ， 定 义 了 RayCube 类 使 用 的 顶点 着 色 
器 。 该 着色 堪 有 两 个 输入 属性 : cubePos 和 
cubeCol， 它 们 分 别 用 于 访问 顶点 的 位 置 和 闫 色 的 
值 。 模 型 视图 和 投影 矩阵 分 别 通 过 uniform 变 量 
uMVMatrix 和 pMatrix 传 入 。vColor 变 量 声 明 为 输 
出 ， 因 为 它 需 要 传 入 片段 着 色 器 ， 在 那里 进行 插 
值 。 在 彝 行 实现 的 片段 着 色 器 ， 将 片段 颜色 设置 为 
传 入 的 vColor 〈 插 值 后 的 ) 值 ，vColor 在 顶点 着 色 
ap UH. 


116.1 定义 颜色 立方 体 的 几何 形状 


现在 ， 看 看 颜色 立方 体 的 几何 形状 ， 它 在 
RayCube 类 中 定义 : 








# cube vertices 
e vertices - numpy.array([ 
, 


POOOO 
OO0OO0OOO 


# cube colors 
(2) colors = numpy.array([ 
0.0, 


NA o 
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0 , 1.0 
]; numpy. float32) 


# individual triangles 
e indices - numpy.array([ 
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umpy.int16) 


在 RayCube 的 构造 函数 中 ， 汇集 了 着 色 器 ， 并 
创建 了 program 对 象 。 在 人 @ 行 定义 了 立方 体 的 几何 
ER, OTEXNTDIE. 


闫 色 立 方 体 有 6 个 面 ， 每 个 面 可 以 绘制 成 两 个 
三 角形 ， 总 共有 6x6 (36) 个 顶点 。 但 是 ， 我 们 不 
是 指定 所 有 36 个 项 点， 而 是 指定 立方 体 的 8 个 顶 





行 和 网 11-5 所 示 。 





X 
图 11-5 ”利用 索引 ， 一 个 立方 体 可 以 表示 为 三 角形 的 集合 ， 


个 面 由 两 个 三 角形 组 成 
Bé PORK, m ED DU fes UN ARR s 


# set up vertex array object (VAO) 

self.vao - glGenVertexArrays(1) 

glBindVertexArray(self.vao) 

# vertex buffer 

self.vertexBuffer = glGenBuffers(1) 

glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 
glBufferData(GL ARRAY BUFFER, 4*len(vertices), vertices, GL S 

# vertex buffer - cube vertex colors 

self.colorBuffer - glGenBuffers(1) 

glBindBuffer(GL ARRAY BUFFER, self.colorBuffer) 
glBufferData(GL ARRAY BUFFER, 4*len(colors), colors, GL STATI 


# index buffer 
self.indexBuffer - glGenBuffers(1) 


e 
glBindBuffer(GL ELEMENT ARRAY BUFFER, self.indexBuffer); 


glBufferData(GL ELEMENT ARRAY BUFFER, 2*len(indices), indices 
GL STATIC DRAW) 


像 以 往 的 项 目 一 样 ， 我 们 可 以 创建 并 绑 定 到 一 

eee dee ae eee 

里 有 一 个 区 别 : TE€MT. indices 2H WIEN 

本 (ro My ARRAY _ BUFFER， 这 意味 着 它 的 

绥 冲 堪 中 的 元 素 将 用 来 索引 和 访问 颜色 和 顶点 绥 冲 
as P RIŽE o 


11.6.2  & e mi E p K WR 





现在 ， 让 我 们 跳 到 创建 帧 缓冲 区 对 象 的 方法 ， 
在 该 方法 中 将 进行 泻 染 。 





def initFBO(self): 
# create frame buffer object 
self.fboHandle - glGenFramebuffers(1) 
# create texture 
self.texHandle - glGenTextures(1) 
# create depth buffer 
self.depthHandle - glGenRenderbuffers(1) 


# bind 
glBindFramebuffer(GL FRAMEBUFFER, self.fboHandle) 


glActiveTexture(GL TEXTUREO) 
glBindTexture(GL TEXTURE 2D, self.texHandle) 


# set parameters to draw the image at different sizes 
EEE Sa GL TEXTURE MIN FILTER, GL LINE 
glTexParameteri(GL TEXTURE 2D, GL TEXTURE MAG FILTER, GL LINE 
glTexParameteri(GL TEXTURE 2D, GL TEXTURE WRAP S, GL CLAMP TO 


glTexParameteri(GL TEXTURE 2D, GL TEXTURE WRAP T, GL CLAMP TO 
# set up texture 


glTexImage2D(GL TEXTURE 2D, ©, GL RGBA, self.width, self.heig 
©, GL RGBA, GL UNSIGNED BYTE, None) 


# bind texture to FBO 
e9 
glFramebufferTexture2D(GL FRAMEBUFFER, GL COLOR ATTACHMENTO, 
GL TEXTURE 2D, self.texHandle, 0) 


# bind 
e glBindRenderbuffer(GL RENDERBUFFER, self.depthHandle) 


glRenderbufferStorage(GL RENDERBUFFER, GL DEPTH COMPONENT24, 
self.width, self.height) 


# bind depth buffer to FBO 


glFramebufferRenderbuffer(GL FRAMEBUFFER, GL DEPTH ATTACHMENT 


GL RENDERBUFFER, self.depthHandle) 
# check status 


o status - glCheckFramebufferStatus(GL FRAMEBUFFER) 
if status -- GL FRAMEBUFFER COMPLETE: 
pass 


#print "fbo %d complete" % self.fboHandle 
elif status -- GL FRAMEBUFFER UNSUPPORTED: 

print "fbo %d unsupported" % self.fboHandle 
else: 

print "fbo %d Error" % self.fboHandle 


这 里 ， 我 们 创建 帧 缓冲 区 对 象 、 二 维 纹理 和 泻 
染 缓 冲 区 对 象 。 然 后 在 @ 行 ， 建 并 了 纹理 参数 。 在 
OT, ZEAR EMRK R. OTME A 
几 行 中 ， 演 染 缓冲 区 设置 了 一 个 24 位 的 深度 缓冲 
X, FPR PIMA KATA. EOT, trast 
区 的 状态 ， 如 果 出 现 错误 则 打印 状态 信息 。 现 在 ， 
只 要 帧 绥 冲 区 和 渔 染 缓冲 区 绑 定 正确 ， 所 有 的 泻 染 
将 进入 纹理 。 


11.63 ” 泻 染 立方 体 的 背 
下 面 的 代码 泻 染 了 颜色 立方 体 的 背面 : 


def renderBackFace(self, pMatrix, mvMatrix): 
"renders back-face of ray- 
cube to a texture and returns it""" 
# render to FBO 
e glBindFramebuffer(GL FRAMEBUFFER, self.fboHandle) 
# set active texture 
glActiveTexture(GL TEXTUREO) 
# bind to FBO texture 
glBindTexture(GL TEXTURE 2D, self.texHandle) 


# render cube with face culling enabled 
(2) self.renderCube(pMatrix, mvMatrix, self.program, True) 


# unbind texture 

e glBindTexture(GL TEXTURE 2D, 0) 
glBindFramebuffer(GL FRAMEBUFFER, 0) 
glBindRenderbuffer(GL RENDERBUFFER, 0) 


# return texture ID 
o return self.texHandle 


在 @ 行 ， 绑 定 FBO， 设 置 活 动 纹理 单 元 ， 并 缘 
定 到 纹理 处 理 程序 ， 这 样 就 可 以 演 染 到 FBO。 在 他 
行 ， 调 用 RayCube 的 renderCube0) 方 法 ， 以 一 个 面 易 
除 标志 为 参数 ， Ben 会 制 立方 体 的 
正面 或 上 背面。 该 标志 设置 为 tue， 让 背面 出 现在 
FBO 纹 理 中 。 IR BOREAM DENS 
绑 定 ， 这 样 其 他 演 染 代码 将 不 受 影响 。 在 @@ 行 返回 
FBO 纹 理 ID， 用 于 算法 的 下 一 阶段 。 


11.6.4 演 染 立方 体 的 正面 


以 下 代码 在 光线 投 届 算 法 的 第 二 通 泻 染 时 ， 绘 
制 颜色 立方 体 的 正面 。 它 就 调用 了 11.6.3 小 节 中 讨 
论 的 renderCube0) 方 法 ， 只 是 面 剔除 标志 设置 为 


False. 














def „EENGEFFFONFFACEN SEIT, pMatrix, 和 program): 
"render front-face of ray-cube" 
# no face culling 
self.renderCube(pMatrix, mvMatrix, program, False) 


11.6.5” 演 染 整 个 立方 体 


现在 看 一 下 renderCube() 方 法 ， 它 绘制 前 面 讨 
论 过 的 彩色 立方 体 : 


def renderCube(self, pMatrix, mvMatrix, program, cullFace): 
"""renderCube uses face culling if flag set""" 


glClear(GL COLOR BUFFER BIT | GL DEPTH BUFFER BIT) 


# set shader program 
glUseProgram(program) 


# set projection matrix 


glUniformMatrix4fv(glGetUniformLocation(program, b'uPMatrix') 
1, GL FALSE, pMatrix) 


# set modelview matrix 


glUniformMatrix4fv(glGetUniformLocation(program, b'uMVMatrix' 
1, GL FALSE, mvMatrix) 


# enable face culling 
glDisable(GL CULL FACE) 


e if cullFace: 
glFrontFace(GL CCW) 
glCullFace(GL_FRONT) 
glEnable(GL_CULL_FACE) 


# bind VAO 
glBindVertexArray(self.vao) 


# animated slice 
© 
glDrawElements(GL TRIANGLES, self.nIndices, GL UNSIGNED SHORT 


# unbind VAO 
glBindVertexArray(0) 


# reset cull face 


if cullFace: 
# disable face culling 
glDisable(GL CULL FACE) 


在 这 个 列表 中 可 以 看 到 ， 我 们 清除 了 颜色 和 深 
ERIK, AmE EIET. KEA S EME 
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决定 了 绘制 立方 体 的 正面 或 背面 。 而 且 ， 我 们 使 用 
了 DrawElements() 信 ， 因 为 要 用 一 个 索引 数组 来 
演 染 立方 体 ， 而 不 是 一 个 顶点 数组 。 


11.6.6 ”调整 大 小 处 理 程序 


由 于 FBO 是 针对 特定 窗口 大 小 创建 的 ， 所 以 窗 
口 大 小 发 生变 化 时 ， 需 要 重新 创建 它 。 要 做 到 这 一 
点 ， 可 以 为 RayCube 类 创建 调整 大 小 的 处 理 程 序 ， 
如 下 所 示 : 





@ def reshape(self, width, height): 
self.width = width 
self.height = height 
self.aspect = width/float(height ) 
# re-create FBO 
self.clearFBO() 
self.initFBO() 


调整 OpenGL 窗 口 的 大 小 时 ， 调 用 f reshape) 
Ke. 


11.7 完整 的 光线 生成 代码 


以 下 是 完整 的 代码 清单 。 也 可 以 
https://github.com/electronut/pp/tree/master/volrender/ 
找到 raycube.py 文 件 。 


import OpenGL 
from OpenGL.GL import * 
from OpenGL.GL.shaders import * 


import numpy, math, sys 
import volreader, glutils 


strVS = niu 
Zversion 330 core 


layout(location - 1) in vec3 cubePos; 
layout(location - 2) in vec3 cubeCol; 
uniform mat4 uMVMatrix; 

uniform mat4 uPMatrix; 

out vec4 vColor; 


void main() 


// set back face color 
vColor = vec4(cubeCol.rgb, 1.0); 


// transformed position 
vec4 newPos = vec4(cubePos.xyz, 1.0); 


// set position 
gl Position - uPMatrix * uMVMatrix * newPos; 


strFS = nau 
Zversion 330 core 


in vec4 vColor; 
out vec4 fragColor; 


void main() 


{ 


fragColor = vColor; 


class RayCube: 
"""class used to generate rays used in ray casting""" 


def _ init (self, width, height): 
"""RayCube constructor""" 


# set dims 
self.width, self.height - width, height 


# create shader 
self.program - glutils.loadShaders(strVS, strFS) 


# cube vertices 
vertices - numpy.array([ 


0.0, 0.0, 0.0, 
1.0, 0.0, 0.0, 
1.0, 1.0, 0.0, 
0.0, 1.0, 0.0, 
0.0, 0.0, 1.0, 
1.0, 0.0, 1.0, 
1.0, 1.0, 1.0, 
0.0, 1.0, 1.0 
], numpy.float32) 


# cube colors 
colors - numpy.array([ 


0.0, 0.0, 0.0, 
1.0, 0.0, 0.0, 
1.0, 1.0, 0.0, 
0.0, 1.0, 0.0, 
0.0, 0.0, 1.0, 
1.0, 0.0, 1.0, 
1.0, 1.0, 1.0, 
0.0, 1.0, 1.0 
], numpy.float32) 


# individual triangles 
indices - numpy.array([ 
4, 9, 7, 
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self.nIndices = indices.size 


# set up vertex array object (VAO) 
self.vao = glGenVertexArrays(1) 
glBindVertexArray(self.vao) 


Zvertex buffer 

self.vertexBuffer - glGenBuffers(1) 

glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 
glBufferData(GL ARRAY BUFFER, 4*len(vertices), vertices, GL S 

# vertex buffer - cube vertex colors 

self.colorBuffer - glGenBuffers(1) 

glBindBuffer(GL ARRAY BUFFER, self.colorBuffer) 
glBufferData(GL ARRAY BUFFER, 4*len(colors), colors, GL STATI 


# index buffer 
self.indexBuffer - glGenBuffers(1) 


glBindBuffer(GL ELEMENT ARRAY BUFFER, self.indexBuffer); 


glBufferData(GL ELEMENT ARRAY BUFFER, 2*len(indices), indices 
GL STATIC DRAW) 


# enable attrs using the layout indices in shader 
aPosLoc = 1 
aColorLoc = 2 


# bind buffers: 
glEnableVertexAttribArray(1) 
glEnableVertexAttribArray(2) 


# vertex 


glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 
glVertexAttribPointer(aPosLoc, 3, GL FLOAT, GL FALSE, 0, None 


# color 
glBindBuffer(GL ARRAY BUFFER, self.colorBuffer) 


glVertexAttribPointer(aColorLoc, 3, GL FLOAT, GL FALSE, 0, No 
# index 


glBindBuffer(GL ELEMENT ARRAY BUFFER, self.indexBuffer) 


# unbind VAO 
glBindVertexArray(0) 


# FBO 
self.initFBO() 


def renderBackFace(self, pMatrix, mvMatrix): 
"""renders back-face of ray- 
cube to a texture and returns it""" 
# render to FBO 
glBindFramebuffer(GL FRAMEBUFFER, self.fboHandle) 
# set active texture 
glActiveTexture(GL TEXTUREO) 
# bind to FBO texture 
glBindTexture(GL TEXTURE 2D, self.texHandle) 


# render cube with face culling enabled 
self.renderCube(pMatrix, mvMatrix, self.program, True) 


# unbind texture 
glBindTexture(GL TEXTURE 2D, 0) 
glBindFramebuffer(GL FRAMEBUFFER, 0) 
glBindRenderbuffer(GL RENDERBUFFER, 0) 


# return texture ID 
return self.texHandle 


def renderFrontFace(self, pMatrix, mvMatrix, program): 
"""render front face of ray-cube""" 
# no face culling 
self.renderCube(pMatrix, mvMatrix, program, False) 


def renderCube(self, pMatrix, mvMatrix, program, cullFace): 
"""render cube use face culling if flag set""" 


glClear(GL COLOR BUFFER BIT | GL DEPTH BUFFER BIT) 
# set shader program 
glUseProgram(program) 


# set projection matrix 


glUniformMatrix4fv(glGetUniformLocation(program, b'uPMatrix') 
1, GL FALSE, pMatrix) 


# set modelview matrix 


glUniformMatrix4fv(glGetUniformLocation(program, b'uMVMatrix' 
1, GL FALSE, mvMatrix) 


# enable face culling 

glDisable(GL CULL. FACE) 

if cullFace: 
glFrontFace(GL CCW) 
glCullFace(GL_FRONT) 
glEnable(GL_CULL_FACE) 


# bind VAO 
glBindVertexArray(self.vao) 


# animated slice 
glDrawElements(GL_TRIANGLES, self.nIndices, GL_UNSIGNED_SHORT 


# unbind VAO 
glBindVertexArray(0) 


# reset cull face 

if cullFace: 
# disable face culling 
glDisable(GL_CULL_FACE) 


def reshape(self, width, height): 
self.width = width 
self.height = height 
self.aspect = width/float(height) 
# re-create FBO 
self.clearFBO() 
self.initFBO() 


def initFBO(self): 
# create frame buffer object 
self.fboHandle - glGenFramebuffers(1) 


# create texture 

self.texHandle - glGenTextures(1) 

# create depth buffer 

self.depthHandle - glGenRenderbuffers(1) 


# bind 
glBindFramebuffer(GL FRAMEBUFFER, self.fboHandle) 


glActiveTexture(GL TEXTUREO) 
glBindTexture(GL TEXTURE 2D, self.texHandle) 


# set parameters to draw the image at different sizes 
glTexParameteri(GL TEXTURE 2D, GL TEXTURE MIN FILTER, GL LINE 
glTexParameteri(GL TEXTURE 2D, GL TEXTURE MAG FILTER, GL LINE 
glTexParameteri(GL TEXTURE 2D, GL TEXTURE WRAP S, GL CLAMP TO 
glTexParameteri(GL TEXTURE 2D, GL TEXTURE WRAP T, GL CLAMP TO 

# set up texture 


glTexiImage2D(GL TEXTURE 2D, ©, GL RGBA, self.width, self.heig 
©, GL RGBA, GL UNSIGNED BYTE, None) 


# bind texture to FBO 


glFramebufferTexture2D(GL FRAMEBUFFER, GL COLOR ATTACHMENTO, 
GL TEXTURE 2D, self.texHandle, 0) 


# bind 
glBindRenderbuffer(GL RENDERBUFFER, self.depthHandle) 


glRenderbufferStorage(GL RENDERBUFFER, GL DEPTH COMPONENT24, 
self.width, self.height) 


# bind depth buffer to FBO 
glFramebufferRenderbuffer(GL FRAMEBUFFER, GL DEPTH ATTACHMENT 
GL RENDERBUFFER, self.depthHandle) 

# check status 

status - glCheckFramebufferStatus(GL FRAMEBUFFER) 

if status -- GL FRAMEBUFFER COMPLETE: 


pass 
#print "fbo %d complete" % self.fboHandle 


elif status == GL FRAMEBUFFER UNSUPPORTED: 
print("fbo %d unsupported" % self.fboHandle) 
else: 
print("fbo %d Error" % self.fboHandle) 


glBindTexture(GL TEXTURE 2D, 0) 
glBindFramebuffer(GL FRAMEBUFFER, 0) 
glBindRenderbuffer(GL RENDERBUFFER, 0) 
return 


def clearFBO(self): 
""Clears old FBO""" 
4 delete FBO 
if glIsFramebuffer(self.fboHandle): 
glDeleteFramebuffers(int(self.fboHandle)) 


# delete texture 
if glIsTexture(self.texHandle): 
glDeleteTextures(int(self.texHandle)) 


def close(self): 
"""call this to free up OpenGL resources'""" 
glBindTexture(GL TEXTURE 2D, 0) 
glBindFramebuffer(GL FRAMEBUFFER, 0) 
glBindRenderbuffer(GL RENDERBUFFER, 0) 
# delete FBO 
if glIsFramebuffer(self.fboHandle): 

glDeleteFramebuffers(int(self.fboHandle)) 


# delete texture 
if glIsTexture(self.texHandle): 
glDeleteTextures(int(self.texHandle)) 


# delete render buffer 
if glIsRenderbuffer(self.depthHandle): 
glDeleteRenderbuffers(1, int(self.depthHandle)) 


# delete buffers 

glDeleteBuffers(1, self._vertexBuffer) 
glDeleteBuffers(1, &_indexBuffer) 
glDeleteBuffers(1, &_colorBuffer) 


11.8 [A62 TES] 


接 下 来 ， 在 RayCastRender 类 中 实现 光线 投射 
算法 。 算 法 的 核心 发 生 在 该 类 使 用 的 片段 着 色 器 
内 ， 该 类 也 使 用 RayCube 类 来 帮助 生成 光线 。 要 查 
看 raycast.py 的 完整 代码 ， 请 直接 跳 到 11.9 节 。 


开始 先 创 建 一 个 RayCube 对 象 ， 并 在 其 构造 函 
数 中 加 载 着 色 器 。 








def | init (self, width, height, volume): 
"""RayCastRender construction""" 


# create RayCube object 
e self.raycube - raycube.RayCube(width, height) 


# set dimensions 

self.width - width 

self.height height 

self.aspect width/float(height) 


# create shader 


(2) self.program = glutils.loadShaders(strVS, strFS) 
# texture 
e self.texVolume, self.Nx, self.Ny, self.Nz - volume 


# initialize camera 
o self.camera - Camera() 


EOT, Ty JST —~7SRayCubertt &, 


用 于 生成 光线 。 在 贸 行 ， 加 载 光 线 投 射 使 用 的 着 色 
器 。 然 后 在 伟 行 ， 设 置 OpenGEL 的 三 维 纹理 和 尺 
寸 ， 它 们 作为 一 个 元 组 传 入 RayCastRender 的 构造 函 
数 。 在 加 行 ， 创 建 一 个 Camera 类 实例 ， 它 将 用 于 设 
置 OpenGL 透 视 转 换 ， 从 而 进行 三 维 泻 染 〈 这 个 类 
与 第 10 章 中 使 用 的 基本 相同 ) 。 


下 面 是 RayCastRender 的 演 染 方法 : 











def draw(self): 
# build projection matrix 


pMatrix - glutils.perspective(45.0, self.aspect, 0.1, 100.0) 
# modelview matrix 
e 


mvMatrix - glutils.lookAt(self.camera.eye, self.camera.center 
self.camera.up) 


# render 
# generate ray-cube back-face texture 
© 


texture = self.raycube.renderBackFace(pMatrix, mvMatrix) 


# set shader program 
o glUseProgram(self.program) 


# set window dimensions 


glUniform2f(glGetUniformLocation(self.program, b"uWinDims"), 
float(self.width), float(self.height)) 


# bind to texture unit 0, which represents back- 
faces of cube 
® glActiveTexture(GL TEXTUREO) 

glBindTexture(GL TEXTURE 2D, texture) 
glUniformii(glGetUniformLocation(self.program, b'texBackFaces 


# texture unit 1: 3D volume texture 


Q glActiveTexture(GL TEXTURE1) 
glBindTexture(GL TEXTURE 3D, self.texVolume) 


glUniformii(glGetUniformLocation(self.program, b"texVolume"), 
# draw front-face of cubes 


self.raycube.renderFrontFace(pMatrix, mvMatrix, self.program) 


在 代行 ， 利 用 glutils.perspectiveO 工 具 方 法 ， 建 
芯 一 个 用 于 演 染 的 透视 投影 和 矩阵。 然后 ， 在 代行， 
将 当前 摄像 机 参数 设置 给 glutils.lookAt( 方 法 。 在 合 
行 ， 完 成 第 一 表演 染 ， 即 利用 RayCube 的 
renderBackFace() 方 法 ， 将 彩色 立方 体 的 背面 绘制 成 
一 个 纹理 (该 方法 也 返回 生成 的 纹理 的 ID)〉。 


在 人 @@ 行 ， 为 光线 投射 算法 局 用 着 色 器 。 然 后 在 
四 行 ， 设 置 息 行 返 回 的 纹理 ， 准 备 将 它 用 于 着 色 器 
程序 中 ， 作 为 纹理 单元 0。 在 @@ 行 ， 设 置 从 读 入 的 
体 数 据 中 创建 的 三 维 纹理 ， 作 为 纹理 单元 1， 这 样 
在 着 色 器 中 就 可 以 用 这 两 个 纹理 。 最 后 ， 在 @ 行 ， 
用 RayCube 的 renderFrontFace0) 方 法 演 染 立方 体 的 正 
面 。 执行 这 段 代 人 码 后 ，RayCastRender 着 色 器 将 作用 
T IU A Fr Bt. 


1181 MAES 


接 下 来 是 RayCastRender 使 用 的 着 色 嚣 。 先 看 
EMAA Ed: 














Zversion 330 core 


@ layout(location = 1) in vec3 cubePos; 
layout(location = 2) in vec3 cubeCol; 


uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 


® out vec4 vColor; 


void main() 


// set position 
gl Position = uPMatrix * uMVMatrix * vec4(cubePos.xyz, 1.0) 


// set color 
O vColor = vec4(cubeCol.rgb, 1.0); 


从 人 @ 行 开始 ， 设 置 位 置 和 颜色 的 输入 变量 。 布 
局 使 用 的 索引 与 RayCube 顶 点 着 色 器 中 定义 相同 ， 
为 RayCastRender 使 用 该 类 中 定义 的 VBO 来 绘制 
几何 形状 ， 着 色 器 中 的 位 置 必 须 相 匹 瑟 。 在 信行 和 
随后 一 行 中 ， 定 义 输入 变换 矩阵 。 然 后， 在 个 行 设 
EUG. TEACH. EHE, 
计算 了 内 建 的 g]_Position 输 出 。 在 @ 行 ， 将 输出 设 
置 为 立方 体 顶 点 的 当前 闫 色 ， 顶 点 之 则 将 进行 插 
值 ， 从 而 在 厂 段 着 色 嚣 中 给 出 正确 的 闫 色 。 


118.2 FREHH 


片段 着 色 器 是 重头 戏 。 它 实现 了 光线 投射 算法 
的 核心 。 








Zversion 330 core 


in vec4 vColor; 


uniform sampler2D texBackFaces; 
uniform sampler3D texVolume; 
uniform vec2 uWinDims; 


out vec4 fragColor; 


void main() 


e 


e 


@ 


@ 


// start of ray 
vec3 start - vColor.rgb; 


// calculate texture coordinates at fragment, 
// which is a fraction of window coordinates 
vec2 texc = gl_FragCoord.xy/uWinDims. xy; 


// get end of ray by looking up back-face color 
vec3 end = texture(texBackFaces, texc).rgb; 


// calculate ray direction 
vec3 dir = end - start; 


// normalized ray direction 
vec3 norm dir = normalize(dir); 


// the length from front to back is calculated and 
// used to terminate the ray 
float len - length(dir.xyz); 


// ray step size 
float stepSize - 0.01; 


// x-ray projection 
vec4 dst - vec4(0.0); 


// step through the ray 
for(float t = 0.0; t « len; t += stepSize) { 


// set position to end point of ray 
vec3 samplePos = start + t*norm dir; 


// get texture value at position 
float val - texture(texVolume, samplePos).r; 
vec4 src = vec4(val); 


// set opacity 
e src.a *= 0.1; 
src.rgb *- src.a; 


// blend with previous value 
© dst = (1.0 - dst.a)*src + dst; 


// exit loop when alpha exceeds threshold 


(10) if(dst.a >= 0.95) 
break; 
} 


// set fragment color 
fragColor = dst; 


片段 着 色 器 的 输入 是 立方 体 顶 点 的 颜色 。 片 自 
着 色 器 也 能 获取 通过 演 染 颜色 立方 体 生成 的 二 维 纹 
理 ， 包 含 数据 的 三 维 纹理 ， 以 及 OpenGL 窗 口 的 尺 
| 


在 片段 着 色 器 执行 时 ， 我 们 传 入 立方 体 的 正 
面 ， 这 样 通 过 在 @ 行 查找 传 入 的 颜色 值 ， 会 得 到 进 
入 这 个 立方 体 的 光线 的 起 点 (回想 一 下 11.1.2 小 节 
中 关于 六 万 体 中 的 左 色 与 光线 万 同 的 联系 的 讨 
162-4 

EO, iB bp SENTRA ERARA hr o 
用 片段 在 窗口 坐标 中 的 位 置 除 以 窗口 尺寸 ， 得 到 范 
围 在 [0,1] 的 值 。 在 全 行 ， 利 用 该 纹理 坐标 来 查找 立 
方 体 的 背面 闫 色 ， 获 得 光线 的 终点 。 


在 信行 ， 计 算 光 线 方 辐 ， 然 后 计算 光线 的 法 癌 




















和 长 度 ， 它 们 将 用 于 光线 投射 计算 。 然 后 在 加 行 ， 
利用 光线 的 起 点 和 方向 ， 直 到 光线 的 终点 ， 我 们 循 
坏 通过 该 物体 。 在 @@ 行 ， 计 算 光 线 在 体 数 据 中 当前 
的 位 置 ， 在 人 @ 行 ， 伍 找 这 一 点 上 的 数据 值 。 


混合 公式 给 出 X 射 线 效 果 ， 在 候 和 人行 执行 。 
我 们 结合 dst 值 和 当前 的 强度 值 〈 它 利用 alpha 值 聚 
YQ) ， 访 过程 沿 光 线 继续 〈alpha 信 不 断 增 加 ) 。 


在 爷 行 ， 检 查 这 个 alpha 值 ， 直 到 它 等 于 最 大 
闵 值 0.95， 束 退出 循环。 最 后 的 结果 是 人 泉 种 平均 的 
EHRE, SIRE MRR, PR AEE AL” RA 
aoe 〈 请 党 试 改 变 阔 值 和 alpha 衰 减 ， 产 生 不 同 的 
BER) 。 





11.9 SCRE OCA DOR TR 


以 下 是 完整 的 代码 清单 。 也 可 以 在 
https://github.com/electronut/pp/tree/master/volrender/ 
找到 raycast.py 文 件 。 


import OpenGL 
from OpenGL.GL import * 
from OpenGL.GL.shaders import * 


import numpy as np 
import math, sys 


import raycube, glutils, volreader 


strVS = Wud 
#version 330 core 


layout(location 
layout(location 


) in vec3 cubePos; 
) in vec3 cubeCol; 


DH 


uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 


out vec4 vColor; 
void main() 
// set position 
gl_Position = uPMatrix * uMVMatrix * vec4(cubePos.xyz, 1.0); 


// set color 
vColor = vec4(cubeCol.rgb, 1.0); 


strFS — nau 
Zversion 330 core 


in vec4 


uniform 
uniform 
uniform 


vColor; 


sampler2D texBackFaces; 
sampler3D texVolume; 
vec2 uWinDims; 


out vec4 fragColor; 


void main() 


// start of ray 
vec3 start = vColor.rgb; 


// calculate texture coords at fragment, 
// which is a fraction of window coords 
vec2 texc = gl_FragCoord.xy/uWinDims. xy; 


// get end of ray by looking up back-face color 
vec3 end = texture(texBackFaces, texc).rgb; 


// calculate ray direction 
vec3 dir = end - start; 


// normalized ray direction 
vec3 norm dir = normalize(dir); 


// the length from front to back is calculated and 
// used to terminate the ray 
float len - length(dir.xyz); 


// ray step size 
float stepSize - 0.01; 


// x-ray projection 
vec4 dst - vec4(0.0); 


// step through the ray 
for(float t = 0.0; t « len; t += stepSize) { 


// set position to end point of ray 
vec3 samplePos = start + t*norm dir; 


// get texture value at position 
float val - texture(texVolume, samplePos).r; 
vec4 src = vec4(val); 


// set opacity 


src.a *= 0.1; 
src.rgb *- src.a; 


// blend with previous value 
dst - (1.0 - dst.a)*src -* dst; 


// exit loop when alpha exceeds threshold 
if(dst.a »- 0.95) 
break; 


j 


// set fragment color 
fragColor - dst; 


class Camera: 

"""helper class for viewing""" 

def _ init (self): 
self.r - 1.5 
self.theta = 0 
self.center = [0.5, 0.5, 0.5] 
self.eye = [0.5 + self.r, 0.5, 0.5] 
self.up - [0.0, 0.0, 1.0] 


def rotate(self, clockWise): 
"""rotate eye by one step""" 
if clockWise: 
self.theta = (self.theta + 5) % 360 
else: 
self.theta - (self.theta - 5) 96 360 
# recalculate eye 


self.eye = [0.5 + self.r*math.cos(math.radians(self.theta)), 


0.5 + self.r*math.sin(math.radians(self.theta)), 
0.5] 


class RayCastRender: 
"""class that does Ray Casting""" 


def _ init (self, width, height, volume): 
"""RayCastRender constr""" 


# create RayCube object 

self.raycube - raycube.RayCube(width, height) 
# set dimensions 

self.width - width 


self.height 
self.aspect 


height 
width/float(height) 


# create shader 

self.program - glutils.loadShaders(strVS, strFS) 

# texture 

self.texVolume, self.Nx, self.Ny, self.Nz - volume 


# initialize camera 
self.camera = Camera() 


def draw(self): 
# build projection matrix 
pMatrix = glutils.perspective(45.0, self.aspect, 0.1, 100.0) 
# modelview matrix 
mvMatrix - glutils.lookAt(self.camera.eye, self.camera.center 
self.camera.up) 
# render 
# generate ray-cube back-face texture 


texture - self.raycube.renderBackFace(pMatrix, mvMatrix) 


# set shader program 
glUseProgram(self.program) 


# set window dimensions 


glUniform2f(glGetUniformLocation(self.program, b"uWinDims"), 
float(self.width), float(self.height)) 


# texture unit 0, which represents back-faces of cube 

glActiveTexture(GL TEXTUREO) 

glBindTexture(GL TEXTURE 2D, texture) 
glUniformii(glGetUniformLocation(self.program, b"texBackFaces 

# texture unit 1: 3D volume texture 

glActiveTexture(GL TEXTURE1) 

glBindTexture(GL TEXTURE 3D, self.texVolume) 


glUniformii(glGetUniformLocation(self.program, b"texVolume"), 


# draw front face of cubes 


self.raycube.renderFrontFace(pMatrix, mvMatrix, self.program) 
Zself.render(pMatrix, mvMatrix) 


def keyPressed(self, key): 


if key == 'L': 
self.camera.rotate(True) 
elif key -- 'r': 


self.camera.rotate(False) 


def reshape(self, width, height): 
self.width - width 
self.height - height 
self.aspect - width/float(height) 
self.raycube.reshape(width, height) 


def close(self): 
self.raycube.close() 


11.10 ÆU 


EIERN SEN, BAT te CEDE 
上 显示 X、y 和 z 方 同上 的 数据 的 二 维 切 请。 这 段 代 
码 封装 在 SliceRender 类 中 ， 它 创建 二 维 体 切 乒 。 要 
查看 slicerender.py 的 完整 代码 ， 请 直接 跳 到 11.11 
"s 


下 面 的 初始 化 代码 为 切片 建立 了 几何 形状 : 


# set up vertex array object (VAO) 
self.vao - glGenVertexArrays(1) 
glBindVertexArray(self.vao) 


# define quad vertices 
e vertexData - numpy.array([ 0.0, 1.0, 0.0, 


], numpy.float32) 
# vertex buffer 

self.vertexBuffer - glGenBuffers(1) 
glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 


glBufferData(GL ARRAY BUFFER, 4*len(vertexData), vertexData, 
GL STATIC DRAW) 
# enable arrays 
glEnableVertexAttribArray(self.vertIndex) 
# set buffers 
glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 


glVertexAttribPointer(self.vertIndex, 3, GL FLOAT, GL FALSE, 


# unbind VAO 
glBindVertexArray(0) 


这 段 代 码 设置 了 一 个 VAO 来 管理 VBO， 像 前 
几 个 例子 一 样 。 在 @ 行 定义 的 几何 形状 是 在 xy 平 面 
上 的 正方 形 (顶点 顺序 是 GL_TRIANGLE_STRIP 的 
顺序 ， 第 9 章 介 绍 过 ) ， 上 所 以 无 论 是 否 显示 垂直 于 
X、Yy 或 z 的 切片 ， 都 使 用 相同 的 几何 形状 。 这 些 情 
况 的 不 同 之 处 在 于 ， 从 三 维 纹理 中 选择 显示 的 数据 
平面 。 讨 论 顶 点 着 色 器 时 ， 会 回 过 头 来 探讨 这 一 


Iwo 





接 下 来 ， 利 用 SliceRender 演 染 二 维 切 片 : 


def draw(self): 
# clear buffers 
glClear(GL COLOR BUFFER BIT | GL DEPTH BUFFER BIT) 
o # build projection matrix 
pMatrix - glutils.ortho(-0.6, 0.6, -0.6, 0.6, 0.1, 100.0) 
# modelview matrix 
(2) mvMatrix = numpy.array([1.0, 0.0, 0.0, 0.0, 
0.0, 1.0, 0.0, 0.0, 
0.0, © 1.0 0, 
-0.5, -0. , 1.0], numpy.floa 
# use shader 
glUseProgram(self.program) 


# set projection matrix 
glUniformMatrix4fv(self.pMatrixUniform, 1, GL_FALSE, pMatrix) 

# set modelview matrix 
glUniformMatrix4fv(self.mvMatrixUniform, 1, GL_FALSE, mvMatri 

# set current slice fraction 
glUniformif(glGetUniformLocation(self.program, b"uSliceFrac" ) 


float(self.currSliceIndex)/float(self.currSliceMax)) 
# set current slice mode 


© 
glUniformii(glGetUniformLocation(self.program, b"uSliceMode") 
self.mode) 


# enable texture 

glActiveTexture(GL TEXTUREO) 

glBindTexture(GL TEXTURE 3D, self.texture) 
glUniformii(glGetUniformLocation(self.program, b"tex"), ©) 


# bind VAO 
glBindVertexArray(self.vao) 

# draw 
glDrawArrays(GL_TRIANGLE_STRIP, 0, 4) 
# unbind VAO 

glBindVertexArray(0) 


每 个 二 维 切 片 都 是 一 个 正方 形 ， 是 用 OpenGL 
的 三 角形 带 图 元 建立 的 。 这 段 代 码 完 成 了 三 角形 带 
的 得 染 设置 。 请 注意 ， 我 们 用 gutils.ortho0) 方 法 实 
现 了 下 投影 。 在 @ 行 ， 建 立 了 一 个 投影 ， 在 表示 切 
片 的 单位 正方 形 边 上 增加 0.1 的 绥 冲 区 。 用 OpenGL 
绘制 时 ， 默 认 视 图 〈 不 应 用 任何 转换 ) 将 眼睛 放 在 
(0, 0, 0) ， 沿 着 z 轴 疝 下 看 而 y 轴 朝 上 。 在 信 
行 ， 对 几何 形状 应 用 转换 (-0.5, -0.5, -1.0) ， 让 
它 围绕 z 轴 居中 。 在 全 行 设 置 当前 切片 的 分 数 〈 例 
如 ，100 个 切片 中 的 第 10 个 将 是 0.1) ， 在 @ 行 设置 
切片 模式 〈 在 x，y 或 z 方 向 上 观看 切片 ， 分 别 由 整 
数 0、1 和 2 表示 ) ， 并 将 这 两 个 值 设置 给 着 色 器 。 


11.10.1 顶点 着 色 器 
现在 来 看 看 SliceRender 的 顶点 着 色 器 : 


























# version 330 core 
in vec3 avert; 


uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 


uniform float uSliceFrac; 
uniform int uSliceMode; 


out vec3 texcoord; 
void main() { 


// X slice 
if (uSliceMode == 0) { 


e texcoord - vec3(uSliceFrac, aVert.x, 1.0-aVert.y); 
} 
// y slice 
else if (uSliceMode == 1) { 

(2) texcoord = vec3(aVert.x, uSliceFrac, 1.0-aVert.y); 


// z slice 
else { 
© texcoord = vec3(aVert.x, 1.0-aVert.y, uSliceFrac); 


} 


// calculate transformed vertex 
gl Position = uPMatrix * uMVMatrix * vec4(aVert, 1.0); 


顶点 着 色 器 用 三 角形 带 顶 点 数组 作为 输入 ， 并 
设置 一 个 纹理 坐标 作为 输出 。 当 前 切片 分 数 和 切片 
模式 作为 uniform 变 量 传 入 。 


在 @ 行 ， 计 算 x 切 片 的 纹理 坐标 。 因 为 要 垂直 
于 x 方 同 切 片 ， 所 以 希望 切片 平行 于 yz 平面 。 传 入 
顶点 着 色 器 的 三 维 顶 点 也 兼作 三 维 纹理 坐标 ， 因 为 
它们 在 [0，1] 的 范围 内 ， 所 以 纹理 坐标 由 《〈f，。 Vx, 








Vy) 给 出 ， 其 中 f 是 x 轴 方 同上 切 厂 编号 的 分 数 ，Vx 


和 Vy 是 顶点 坐标 。 遗 憾 的 是 ， 由 此 产生 的 图 像 是 倒 
的 ， A OpenGL a AAW MEAL FAR, yJj In] 


朝 上 。 这 和 我 们 希望 的 相反 。 为 了 解决 这 个 问题 ， 
将 纹理 坐标 t 改 为 (1 - t) ， 采 用 Cf, Vx, 1- Vy) , 
如 人 @ 行 所 示 。 在 信行 和 人 @ 行 ， 利 用 类 似 的 逻辑 来 计 
算 y 和 z 方 同上 切片 的 纹理 坐标 。 


11.102 FREEK 
File Hr BOB ER: 


# version 330 core 
€9 in vec3 texcoord; 
uniform sampler3D texture; 
out vec4 fragColor; 
void main() ( 
// look up color in texture 
e vec4 col - texture(tex, texcoord); 


o fragColor - col.rrra; 


j 





在 @ 行 ， 片段 着 色 器 声明 texcoord 作 为 输入 ， 
它 在 顶点 着 色 器 中 设 为 输出 。 在 信行 ， 该 纹理 采样 
器 声明 为 uniform。 在 信行 ， 用 texcoord 和 查找 纹理 的 
颜色 ， 在 @ 行 ， 设 置 fragColor 作 为 输出 (因为 读 入 
纹理 时 只 作为 红色 通道 ， 所 以 使 用 col.rrra)。 


11.10.3 ”针对 二 维 切 片 的 用 户 界 面 


现在 需要 为 用 户 提 供 一 种 方法 ， 让 切片 经 过 这 
些 数据 。 用 SliceRender 的 键盘 处 理 程 序 来 实现 。 


def keyPressed(self, key): 

"""keypress handler""" 

if key == 'x': 
self.mode - SliceRender.XSLICE 
# reset slice index 
self.currSlicelndex - int(self.Nx/2) 
self.currSliceMax = self.Nx 

elif key == 'y': 
self.mode - SliceRender.YSLICE 
4 reset slice index 
self.currSliceIndex = int(self.Ny/2) 
self.currSliceMax - self.Ny 

elif key -- 'z': 
self.mode - SliceRender.ZSLICE 
4 reset slice index 
self.currSlicelndex - int(self.Nz/2) 
self.currSliceMax = self.Nz 

elif key == 'l': 


self.currSliceIndex = (self.currSliceIndex + 1) % self.currSl 
elif key == 'r': 


self.currSliceIndex = (self.currSliceIndex - 1) % self.currSl 


在 键盘 上 按 下 X、Y 或 Z 刍 时，SliceRender 切 换 
到 的 x、y 或 z 切 片 模式 。 在 @ 行 ， 可 以 看 到 x 切片 的 
效果 ， 随 后 将 当前 切片 索引 设置 为 数据 的 中 间 位 
Bo FEJRE AURA. JR PERS EHE. Gar 
键 ， 就 实现 了 切片 翻 页 。 在 人 @ 行 ， 按 下 右 箭头 时 切 
片 索引 递增 。 取 模 运 算 符 CO) 确保 在 超过 最 大 值 





时 索引 “翻转 ”为 0。 


111 完整 的 二 维 切片 代码 


以 下 是 完整 的 代码 清单 。 也 可 以 在 
https://github.com/electronut/pp/tree/master/volrender/ 
找到 slicerender.py 文 件 。 


import OpenGL 

from OpenGL.GL import * 

from OpenGL.GL.shaders import * 
import numpy, math, sys 


import volreader, glutils 


strVS = 


# version 330 core 


in vec3 


uniform 
uniform 


uniform 
uniform 


aVert; 


mat4 uMVMatrix; 
mat4 uPMatrix; 


float uSliceFrac; 
int uSliceMode; 


out vec3 texcoord; 


void main() { 


// X slice 
if (uSliceMode == 0) { 
texcoord - vec3(uSliceFrac, aVert.x, 1.0-aVert.y); 


} 


// y slice 
else if (uSliceMode == 1) { 
texcoord = vec3(aVert.x, uSliceFrac, 1.0-aVert.y); 


// z slice 
else { 


texcoord = vec3(aVert.x, 1.0-aVert.y, 


J 


// calculate transformed vertex 


uSliceFrac); 


gl Position = uPMatrix * uMVMatrix * vec4(aVert, 1.0); 


StrFS = nau 
# version 330 core 


in vec3 texcoord; 
uniform sampler3D tex; 
out vec4 fragColor; 


void main() { 
// look up color in texture 
vec4 col = texture(tex, texcoord); 
fragColor - col.rrra; 


j 


class SliceRender: 
# slice modes 
XSLICE, YSLICE, ZSLICE - 0, 1, 2 


def _ init (self, width, height, volume): 


"""S]liceRender constructor""" 


self.width - width 
self.height height 
self.aspect 


# slice mode 


self.mode - SliceRender.ZSLICE 


# create shader 


width/float (height) 


self.program - glutils.loadShaders(strVS, strFS) 


glUseProgram(self.program) 


self.pMatrixUniform - glGetUniformLocation(self.program, b'u 


self.mvMatrixUniform = glGetUniformLocation(self.program, 


# attributes 


b"uMVMatrix") 


self.vertIndex = glGetAttribLocation(self.program, b"aVert") 


# set up vertex array object (VAO) 
self.vao - glGenVertexArrays(1) 
glBindVertexArray(self.vao) 


# define quad vertices 
vertexData - numpy.arr 


£e 


0, 1 
0, 0 
0, 0 


, 


y([ 0. 
0, O. 
0, 1. 


, 


0, 0.0, 
0, 
0 


e co 


1.0, 0.0, 0.0], numpy.float32) 
# vertex buffer 
self.vertexBuffer - glGenBuffers(1) 
glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 


glBufferData(GL ARRAY BUFFER, 4*len(vertexData), vertexData, 
GL STATIC DRAW) 
# enable arrays 
glEnableVertexAttribArray(self.vertIndex) 
# set buffers 
glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 


glVertexAttribPointer(self.vertIndex, 3, GL FLOAT, GL FALSE, 


# unbind VAO 
glBindVertexArray(0) 


# load texture 
self.texture, self.Nx, self.Ny, self.Nz = volume 


# current slice index 
self.currSliceIndex = int(self.Nz/2); 
self.currSliceMax = self.Nz; 


def reshape(self, width, height): 
self.width - width 
self.height - height 
self.aspect - width/float(height) 
def draw(self): 
# clear buffers 
glClear(GL COLOR BUFFER BIT | GL DEPTH BUFFER BIT) 
# build projection matrix 


pMatrix - glutils.ortho(-0.6, 0.6, -0.6, 0.6, 0.1, 100.0) 


# modelview matrix 

mvMatrix - numpy.array([1.0, 0.0, 0.0, 0.0, 
0.0, 1.0, 0.0, 0.0, 
0.0, 0.0, 1.0, 0.0, 


-0.5, -0.5, -1.0, 1.0], numpy.floa 
# use shader 


glUseProgram(self.program) 

# set projection matrix 
glUniformMatrix4fv(self.pMatrixUniform, 1, GL FALSE, pMatrix) 

# set modelview matrix 
glUniformMatrix4fv(self.mvMatrixUniform, 1, GL FALSE, mvMatri 

# set current slice fraction 
glUniformif(glGetUniformLocation(self.program, b"uSliceFrac") 


float(self.currSliceIndex)/float(self.currSliceMax)) 
# set current slice mode 


glUniformii(glGetUniformLocation(self.program, b"uSliceMode") 
self.mode) 


# enable texture 
glActiveTexture(GL TEXTUREO) 
glBindTexture(GL TEXTURE 3D, self.texture) 


glUniformii(glGetUniformLocation(self.program, b"tex"), ©) 


# bind VAO 
glBindVertexArray(self.vao) 

# draw 
glDrawArrays(GL_TRIANGLE_STRIP, 0, 4) 
# unbind VAO 

glBindVertexArray(0) 


def keyPressed(self, key): 

"""keypress handler""" 

if key == 'x': 
self.mode = SliceRender.XSLICE 
# reset slice index 
self.currSliceIndex = int(self.Nx/2) 
self.currSliceMax = self.Nx 

elif key == 'y': 
self.mode - SliceRender.YSLICE 


# reset slice index 
self.currSliceIndex = int(self.Ny/2) 
self.currSliceMax - self.Ny 

elif key -- 'z': 
self.mode = SliceRender.ZSLICE 
# reset slice index 
self.currSliceIndex = int(self.Nz/2) 
self.currSliceMax - self.Nz 

elif key == 'l': 


self.currSliceIndex = (self.currSliceIndex + 1) % self.currSl 
elif key == 'r': 


self.currSliceIndex = (self.currSliceIndex - 1) % self.currSl 


def close(self): 
pass 


11.12 {Viste 





LEA Rak a ANE Sc Fvolrender.py. 1% 
文件 用 到 RenderWin 类 ， 它 创建 并 管理 GLFW 的 
OpenGL 窗 口 〈 这 里 不 会 详细 介绍 该 类 ， 因 为 它 类 
似 于 第 9 章 和 第 10 间 中 使 用 的 类 ) 。 要 奉 看 
volrender.py 的 完整 代码 ， 请 直接 跳 到 11.13 市 。 


在 这 个 类 的 初始 化 代码 中 ， 创 建 了 渔 染 带 ， 如 
PATA: 








# load volume data 
e self.volume = volreader.loadVolume(imageDir) 
# create renderer 


self.renderer - RayCastRender(self.width, self.height, self.v 


在 人 @ 行 ， 读 入 三 维 数 据 作为 OpenGL 纹 理 。 在 
人 @ 行 ， 创 建 RayCastRender 类 型 的 对 象 来 显示 数据 。 


gett Eik PV GE, FEMME AMY ie ez AY 
换 。 下 面 是 RenderWindow 的 键盘 处 理 程序 : 


def onKeyboard(self, win, key, scancode, action, mods): 
# print 'keyboard: ', win, key, scancode, action, mods 
# ESC to quit 


if key is glfw.GLFW KEY ESCAPE: 
self.renderer.close() 
self.exitNow - True 
else: 
e 
if action is glfw.GLFW PRESS or action is glfw.GLFW REPEAT: 
if key == glfw.GLFW KEY V: 
# toggle render mode 
(2) if isinstance(self.renderer, RayCastRender): 


self.renderer = SliceRender(self.width, self.height, 
self.volume) 
else: 


self.renderer = RayCastRender (self.width, self.height, 
self.volume) 
# call reshape on renderer 


self.renderer.reshape(self.width, self.height) 
else: 
# send keypress to renderer 


® 
keyDict = {glfw.GLFW_KEY X: 'x', glfw.GLFW KEY Y: 'y', 
glfw.GLFW KEY Z: 'z', glfw.GLFW KEY LEFT: 'l', 
glfw.GLFW KEY RIGHT: 'r'} 
try: 

self.renderer.keyPressed(keyDict [key]) 
except: 

pass 


按 ESC 键 退出 程序 。 其 他 按键 (V, X, Y, Z 
等 ) 在 @@ 行 处 理 ( 无 论 刚刚 按 下 该 键 ， 或 者 保持 按 
下 状态 ， 代 码 都 有 效 ) 。 在 @ 行 ， 如 果 按 下 V 键 ， 
在 体 泻 染 和 切片 泻 染 之 间 切 换 ， 利 用 Python 的 
isinstance() 方 法 来 确定 当前 类 的 类 型 。 


要 处 理 除 ESC 之 外 的 按键 事件 ， 我 们 使 用 一 个 
字典 全 ， 将 按 下 的 键 传 入 泻 染 器 的 keyPressed() 处 理 





我 没有 直接 传 入 glfw.KEY 值 ， 而 是 利用 字典 将 它们 转换 为 字符 
值 ， 因 为 这 是 很 好 的 做 法 ， 目 的 是 减少 源 文 件 中 的 依赖 关系 。 目 
前 ， 项 目 中 依赖 GLFW 的 唯一 文件 是 volrender.py。 如 果 将 GLFW 相 
关 的 类 型 传 入 其 他 代码 ， 它 们 就 需要 导入 并 依赖 GLFW 库 ， 但 如 果 
切换 到 另 一 个 OpenGL 窗 口 工具 包 ， 人 代码 就 乱 了 。 


11.13 ”完整 的 主 文 件 代码 


以 下 是 完整 的 代码 清单 。 也 可 以 在 
https://github.com/electronut/pp/tree/master/volrender/ 
找到 volrender.py 文 件 。 


import sys, argparse, os 
from slicerender import * 
from raycast import * 
import glfw 


class RenderWin: 
"""GLFW Rendering window class""" 
def _ init (self, imageDir): 


# save current working directory 
cwd = os.getcwd() 


# initialize glfw; this changes cwd 
glfw.glfwInit() 


# restore cwd 
os.chdir(cwd) 


# version hints 
glfw.glfwwindowHint(glfw.GLFW CONTEXT VERSION MAJOR, 3) 
glfw.glfwwindowHint(glfw.GLFW CONTEXT VERSION MINOR, 3) 
glfw.glfwwindowHint(glfw.GLFW OPENGL FORWARD COMPAT, GL TRUE) 

glfw.glfwwindowHint(glfw.GLFW OPENGL PROFILE, 

glfw.GLFW OPENGL CORE PROFILE) 

# make a window 


self.width, self.height - 512, 512 
self.aspect - self.width/float(self.height) 


self.win = glfw.glfwCreatewindow(self.width, self.height, b"v 
# make context current 
glfw.glfwMakeContextCurrent(self.win) 


# initialize GL 

glViewport(0, ©, self.width, self.height) 
glEnable(GL_DEPTH_TEST) 

glClearColor(0.0, 0.0, 0.0, 0.0) 


# set window callbacks 


glfw.glfwSetMouseButtonCallback(self.win, self.onMouseButton) 
glfw.glfwSetKeyCallback(self.win, self.onKeyboard) 
glfw.glfwSetWindowSizeCallback(self.win, self.onSize) 


# load volume data 
self.volume = volreader.loadVolume(imageDir) 
# create renderer 


self.renderer - RayCastRender(self.width, self.height, self.v 


# exit flag 
self.exitNow = False 


def onMouseButton(self, win, button, action, mods): 
# print 'mouse button: ', win, button, action, mods 
pass 


def onKeyboard(self, win, key, scancode, action, mods): 
# print 'keyboard: ', win, key, scancode, action, mods 
# ESC to quit 
if key is glfw.GLFW KEY ESCAPE: 
self.renderer.close() 
self.exitNow - True 
else: 


if action is glfw.GLFW PRESS or action is glfw.GLFW REPEAT: 
if key -- glfw.GLFW KEY V: 
# toggle render mode 
if isinstance(self.renderer, RayCastRender ): 


self.renderer - SliceRender(self.width, self.height, 
self.volume) 
else: 


self.renderer - RayCastRender(self.width, self.height, 
self.volume) 
# call reshape on renderer 


self.renderer.reshape(self.width, self.height) 
else: 
# send keypress to renderer 


keyDict = (glfw.GLFW KEY X: 'x', glfw.GLFW KEY Y: 'y', 
glfw.GLFW KEY Z: 'z', glfw.GLFW KEY LEFT: 'l', 
glfw.GLFW KEY RIGHT: 'r'} 
try: 
self.renderer.keyPressed(keyDict [key]) 
except: 
pass 


def onSize(self, win, width, height): 
#print 'onsize: ', win, width, height 
self.width - width 
self.height height 
self.aspect width/float(height) 
glViewport(0, 0, self.width, self.height) 
self.renderer.reshape(width, height) 


def run(self): 
# start loop 


while not glfw.glfwWindowShouldClose(self.win) and not self.e 

# render 
self.renderer.draw() 
# swap buffers 
glfw.glfwSwapBuffers(self.win) 
# wait for events 
glfw.glfwwaitEvents() 

# end 

glfw.glfwTerminate() 


# main() function 

def main(): 
print('starting volrender...') 
# create parser 


parser = argparse.ArgumentParser(description="Volume Renderin 
# add expected arguments 
parser.add argument('-- 
dir', dest-'imageDir', required-True) 
# parse args 
args - parser.parse args() 


# create render window 


rwin = RenderWin(args.imageDir) 
rwin.run() 


# call main 
if _name__ == ' main ': 
main() 


11.14 运行 程序 


下 和 面 是 用 斯 坦 福 体 数据 档案 (Stanford Volume 
Data Archive) 局 的 数据 来 运行 应 用 程序 的 示例 。 


$ python volrender.py --dir mrbrain-8bit/ 





应 该 看 到 如 图 11-6 所 示 的 画面 。 


800 volrender 800 volrender 





图 11-6 ”virender.by 运 行 示例 。 左 侧 的 图 像 是 体 泻 染 ， 右 侧 的 
图 像 是 二 维 切 片 


11.15 小结 


本 和 章 用 Python 和 OpenGL 实 现 了 体 光 线 投 射 算 
法 。 我 们 学 习 了 如 何 用 GLSL 着 色 器 有 效 地 实现 这 
个 算法 ， 以 及 如 何 从 体 数 据 创建 二 维 切 厂 。 


11.16 ”实验 


这 里 有 一 些 方法 ， 让 你 继续 完善 体 光 线 投 冉 程 
FF. 


1. 目前 ， 在 光线 投射 模式 下 ， 很 难看 到 的 体 
数据 “立方 体 ” 的 边界 。 请 实现 一 个 WireFrame 类 ， 
围绕 该 立方 体 绘制 一 个 合子。 分 别 用 红 、 绿 、 蓝 色 
绘制 x、y 和 z 轴 ， 让 它们 每 个 都 有 自己 的 着 色 器 。 
在 RayCastRender 类 中 使 用 WireFrame。 


2. 实现 数据 刻度 。 在 当前 的 实现 中 ， 人 针对 物 
体 绘制 了 一 个 正方 体 ， 和 针对 二 维 切 片 了 一 个 正方 
形 ， 这 假定 数据 集 是 对 称 ( 即 切片 的 数目 在 每 个 方 
问 上 相同 ) ， 但 大 多 数 实 际 数据 具有 不 同 数目 的 切 
片 。 特 别 是 医疗 数据 ， 和 津津 在 z 方 同 的 切片 较 少 ， 
例如 ， 维 度 是 256x256x99。 要 正确 显示 这 些 数据 ， 
必须 在 计算 中 引入 刻度 。 一 种 做 法 是 将 刻度 应 用 于 
立方 体 的 顶点 (三 维 物体 ) 和 正方 形 的 顶点 (二 维 
po 
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式 是 用 最 大 强度 投影 (maximum intensity 








projection, MIP) ， 在 每 个 像 尿 上 设置 最 大 强度 。 
在 代码 中 实现 这 一 点 〈 提 示 : 在 RayCastRender 的 片 
段 着 色 嚣 中， 修改 逐 步 穿 透 光线 的 代码 ， 沿 看 光线 
MAIR EIR AE, TABATA) 。 


4. 目前 ， 唯 一 实现 的 用 户 界 面 是 围绕 x 轴 、y 
轴 和 z 轴 旋转 。 请 实现 缩放 功能 ， 按 键 或 O 键 来 放 
大 或 缩小 体 泻 染 图 像 。 可 以 在 glutils.lookAtO 方 法 中 
设置 适当 的 相机 参数 来 实现 ， 有 一 点 需要 注意 : 如 
果 将 观察 位 置 移动 到 立方 体内 部 ， 光 线 投 喘 将 失 
败 ， 因 为 OpenGL 会 裁剪 立方 体 的 正面 。 光 线 投射 
所 需 的 光线 计算 ， 同 时 需要 彩色 立方 体 的 正面 和 硼 
面 才 能 正确 泻 染 。 作 为 蔡 代 方案 ， 通 过 在 
ghutils.projecton0) 方 法 中 调节 视 场 来 实现 缩放 。 














[1] J. Kruger and R. Westermann, “Acceleration 
Techniques for GPU-based Volume Rendering," IEEE 
Visualization, 2003. 


[2] http://graphics.stanford.edu/data/voldata/ 
[3] http://graphics.stanford.edu/data/voldata/ 


第 五 部 分 “ 玩 转 使 件 


“系统 中 的 那些 可 以 用 锤子 击 打 〈 不 建议 这 么 做 ) 
的 部 分 称 为 硬件 ， 


那些 只 能 充 名 的 程序 指令 称 为 软件 。” 
一 一 佚名 





第 12 瘟 ”Arduino 人 简介 





Arduino 是 一 个 简单 的 微 控制 磺 板 卡 ， 是 基于 
可 编程 心 片 的 开源 开发 环境 。 所 有 版 本 的 Arduino 
都 包含 计算 机 的 标准 组 件 ， 如 内 存 、 处 理 器 和 输入 / 
输出 系统 。 


在 本 章 中 ， 我 们 将 在 Arduino 的 帮助 下 开始 进 
入 人 铀 控制 占有 的 世界 。 我 们 将 学 习 Arduino 平 台 的 基 
础 知识 ， 以 及 如 何 用 Arduino 编 程 语言 (C++ 的 一 个 
版 本 ) 构建 Arduino 程 序 。 我 们 将 学 习 如 何 对 
Arduino 进 行 编程 ， 从 一 个 简单 的 光 传 感 器 电路 收 
集 数 据 ， 然 后 通过 串 行 端口 将 数据 发 送 给 计算 机 。 
接 下 来 ， 我 们 将 用 pySerial 通 过 串口 与 Arduino 交 


互 ， 收 集 数据 ， 并 用 matplotlib 实 时 绘制 图 形 。 新 值 
输入 时 ， 图 形 将 问 右 深 动 ， 束 像 EKG 监 视 右 一 样 。 
其 电路 设置 如 图 12-1 所 示 。 
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图 12-1 简单 的 光敏 电阻 (LDR) 电路 ， 在 面包 板 上 搭建 ， 并 
连接 到 Arduino Uno 


12.1 Arduino 


Arduino 是 围绕 一 类 名 为 Atmel AVR 的 微 控制 
妖 心 片 构建 的 平台 。 市 场 上 有 许多 不 同 尺寸 和 功能 
的 Arduino 板 。 图 12-2 突 出 了 Arduino ”Uno 板 卡 的 一 
些 主要 组 件 ， 这 是 比较 常见 的 、 可 以 获得 的 板 卡 。 
Arduino 板 上 的 接头 〈 如 图 12-2 所 示 ) 允许 你 访问 微 
控制 右 的 模拟 和 数字 引 脚 ， 以 便 通 过 发 送 和 接收 数 
据 ， 与 其 他 电子 设备 通信 。 (我 推荐 阅读 John 
Boxall 的 《Arduino Workshop》 一 书 [No Starch 
Press，2013]， 以 便 更 好 地 理解 Arduino 的 电子 和 编 
TEAM. ) 








USB 连 接 器 数字 输入 /输出 引 脚 
pL——————————4 





TT 
axem ARDUINO 
oe 


微 控制 器 


电源 输出 模拟 引 脚 
外 部 电源 供应 
图 12-2 Arduino Uno 板 卡 的 组 件 





虽然 本 书 的 项 目 中 使 用 Arduino ”Uno 板 ， 但 你 应 该 能 够 使 用 非 
官方 的 板 卡 。 如 果 打 算 这 样 做 ， 请 参阅 Arduino 网 站 
Chttp://arduino.cc/) ， 了 解 板 卡 之 间 的 区 别 。 例 如 ， 一 些 板 卡 的 引 
脚 编写 惯例 与 Uno 不 同 。 
Arduino ”Uno 有 一 个 微 控 制 占 已 片 ， 一 个 通用 
串 行 总 线 (USB) 连接 ， 一 个 用 于 外 部 电源 的 插 
孔 ， 一 些 数 字 输 入 /输出 引 脚 ， 一 些 模拟 引 脚 ， 可 供 
外 部 电路 使 用 的 电源 输出 ， 其 至 有 直接 对 心 厂 编 程 
的 引 脚 。 





Arduino 板 卡 包括 一 个 “引导 加 载 程 序 
(bootloader) ”， 它 是 一 个 程序 ， 让 你 上 传代 码 并 
在 微 控 制 器 上 运行 。 如 果 没 有 引导 加 载 程序 ， 则 要 
用 “在 线 串 行 编程 技术 (ACSP) ”与 微 控 制 器 进行 交 
互 〈 通 过 名 为 ICSP 头 的 外 部 编程 引 脚 ，Arduino 文 
持 了 ICSP) 。Arduino 易 于 编程 ， 因 为 可 以 通过 
USB 端 口 将 它 连接 到 计算 机 ， 并 用 Arduino 软 件 将 代 
1 EE R FA ERAN o 


Arduino 板 卡 最 重要 的 组 件 是 AVR 微 控制 器 ， 
它 是 一 个 单 片 计 算 机 。Arduino ”Uno 上 的 AVR 微 控 
制 器 是 一 个 ATmega328 芯 片 。 它 有 中 央 处 理 单元 
(CPU) 、 定 时 器 /计数 器 、 模 拟 和 数字 引 脚 、 存 储 
器 模块 和 时 钟 模 块 等 。 芯 片 的 CPU 执行 上 传 的 程 
序 。 定 时 器 /计数 器 模块 可 用 于 在 程序 内 创建 周期 性 
事件 〈 例 如 每 秒 检查 某 个 数字 引 脚 的 值 ) 。 模 拟 引 
脚 使 用 模 数 转换 器 (ADC) 模块 将 输入 的 模拟 信和 号 
转换 为 数字 值 ， 数 字 引 脚 可 以 作为 输入 或 输出 ， 具 
体 取决 于 如 何 设 置 。 





12.2 Arduino/1 5 AR 


Arduino 处 在 一 个 生态 系统 的 中 心 ， 这 个 生态 
系统 将 编程 语言 与 集成 开发 环境 CDE) 、 文 持 性 
和 创造 性 的 社区 以 及 大 量 外 设 结 合 起 来 。 


12.2.1 语言 


Arduino 编 程 语 言 是 C++ 的 简化 版 本 ， 起 源 于 处 
理 和 布线 (Processing and Wiring) 原型 语言 。 它 的 
设计 目的 是 让 不 束 悉 编程 的 人 容易 使 用 。 为 
Arduino 编 写 的 程序 称 为 “草图 (sketches) ”( 有 关 
Arduino 编 程 语言 的 更 多 信息 ， 请 访问 
http://arduino.cc/) . 


12.2.2 IDE 


Arduino 包 括 一 个 简单 的 IDE， 可 以 在 其 中 创建 
草图 并 上 传 到 Arduino 〈 人 参见 图 12-3) 。IDE 还 包括 
一 个 “ 串 行 监视 器 (serial monitor) ”， 可 以 通过 让 
Arduino 经 串口 问 计 算 机 发 送信 息 ， 来 调试 应 用 程 
序 。 此 外 ，IDE 还 包括 几 个 示例 程序 ， 以 及 一 系列 
用 于 执行 常见 任务 ， 并 与 外 部 的 外 设 板 卡 
x D. 














ardu alert 





// ardu alert.ino 

/ f 

ff read serial port and turn leds on/off 
f £ i 

ff Mahesh Venkitachalam 

// electronut.in 

#include "Arduino.h" 

// LED pin numbers (digital) 
int pinRed = 4; 

int pinGreen = 2; 

void setup() 

{ 


// initialize serial comms 
Serial .begin(9608); 


ff set pins 


pinMode(pinRed, OUTPUT); 
pinMode(pinGreen, OUTPUT); 


void loop() 
1 


4» 


A aw 


图 12-3 Arduino IDE 中 的 示例 程序 
12.2.3 社区 


Arduino 有 一 个 庞大 的 用 户 群 ， 如 果 对 一 个 项 
目 有 疑问 ， 你 可 以 加 Arduino 社 区 寻求 帮助 。 
Arduino 社 区 已 经 开发 了 许多 开源 库 ， 可 以 在 你 的 
项 目 中 使 用 ， 如 果 用 Arduino 连 接 一 些 传感器 模块 
时 过 到 困难 ， 很 可 能 有 人 已 经 解决 了 这 个 问题 ， 并 
提供 了 一 个 库 ， 使 你 的 生活 更 轻松 。 


12.2.4 ^M 


与 所 有 流行 的 平台 一 样 ， 围 绕 Arduino 平 台 建 
并 了 一 个 产业 。 大 量 的 功能 扩展 板 〈 可 以 方便 地 安 
JTE Arduino 上， 以 便 访 问 传 感 咒 和 其 他 电子 元 件 
的 板 卡 ) 、 分 线 板 《〈 可 以 方便 地 连接 难以 焊接 的 元 
件 / 电 路 ) 和 其 他 外 设 ， 都 可 用 于 Arduino， 其 中 许 
多 可 以 让 你 的 项 目 更 简单 。SparkFun 
Electronics Chttps://www.sparkfun.com/) 和 Adafruit 
Industries Chttp://www.adafruit.com/) 是 两 家 公司 ， 
它们 分 别提 供 了 许多 可 与 Arduino 一 起 使 用 的 产 
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12.3 ”所 需 模块 





既然 已 经 知 道 了 Arduino 的 一 些 基础 知识 ， 束 
让 我 们 看 看 如 何 对 板 卡 编程 ， 从 光 感 测 电路 读 取 数 
据 。 除 了 Arduino， 我 们 还 需要 两 个 电阻 和 两 个 “ 光 
敏 电阻 CLDR) ”。 电 阻 用 于 减少 通过 电路 的 电 沉 
并 降低 电压 。 我 们 将 使 用 光敏 电阻 (也 称 为 
photoresistor) ， 其 电阻 随 看 光照 强度 的 增加 而 减 
小 。 我 们 还 需要 一 个 面包 板 和 一 些 电线 来 搭 电路 ， 
并 用 万 用 表 来 检查 连接 。 








12.4 搭建 感光 电路 


首先 ， 我 们 将 搭建 感光 电路 ， 它 由 两 个 常规 电 
了 组 和 两 个 LDR 组 成 。 图 12-4 展 示 了 感光 电路 的 电路 
图 《附录 B 包 合 如 何 开 如 搭建 电子 电路 的 一 些 基本 
信息 ) 。 


在 图 12-4 中 ，VCC 表 示 连 接 到 Arduino 的 5V 输 
出 ， 它 为 电路 供电 。 标 记 为 LDR1 和 LDR2 的 元 件 是 
两 个 光敏 电阻 ，A0 和 A1 是 Arduino 的 模拟 引 脚 0 和 
1〈 这 些 模 拟 引 脚 允 许 微 控制 器 从 外 部 电路 读 取 电 
压 电 平 ) 。 你 还 可 以 看 到 电阻 R1 和 R2， 以 及 接地 
(GND) 连接 ， 它 可 以 是 Arduino 上 的 任何 GND 引 
脚 。 可 以 在 面包 板 〈 带 弹 黎 夹 的 塑料 板 ， 用 于 在 不 
焊接 的 情况 下 组 装 电 路 ) 上 搭建 电路 ， 用 少量 电线 
连接 ， 如 图 12-1 所 示 。 


12.4.1 电路 工作 原理 


在 该 电路 中 ， 每 个 LDR 和 它 下 面 的 电阻 ， 构 成 
了 “电阻 分 压 器 ”>， 这 是 一 个 简单 电路 ， 用 两 个 电阻 
将 输入 电压 分 为 两 部 分 。 该 设置 意味 着 A0 处 的 电压 
计算 如 下 : 








Rı 


Vo = V 一 一 
RLDR + Rı 


R 1 是 电阻 的 阻 值 ， R DR 十 LDR 的 阻 值 。 Viz 
电源 电压 ，V GER 1 两 端的 电压 。 随 关照 在 LDR 上 
的 光 强 度 改变 ， 它 的 电阻 也 改变 ， 因 此 它 两 端的 电 
压 也 相应 地 改变 。 电 压 〈0 至 5 伏特 之 间 ) 在 A0 处 读 
取 ， 并 作为 10 位 值 发 送 给 程序 ， 范 围 为 [0,1023]。 
即 电压 范围 映射 为 [0,1023] 的 整数 。 


在 电路 中 使 用 的 R 1 和 R ,电阻 的 值 取决 于 选择 
的 LDR。 如 果 用 光照 LDR， 其 电阻 会 降低 ， 因 此 R 
TDR 减 小 ， 这 意味 着 V 0 增加 ，Arduino 从 连接 到 该 
LDR 的 模拟 引 脚 处 读 入 较 高 的 值 。 要 确定 R 1 和 R » 
所 需 的 电阻 值 ， 请 在 不 同 光 线条 VE FIRE 
LDR 的 电阻 ， 并 将 该 值 代 入 电压 公式 。 你 希望 在 使 
even 电压 有 好 的 变化 (从 
0V 到 5V) 。 


我 最 后 用 了 4.7k 欧 姆 电阻 作为 R_ 1 和 R >， 因 为 
我 的 LDR 的 电阻 从 大 约 10k 欧 姆 〈 在 黑暗 中 ) 变化 
到 1k 欧 姆 〈 在 明亮 的 光线 中 ) 。 将 这 些 值 代入 上 一 
个 公式 中 ， 会 看 到 模拟 输入 需要 1.6V 至 4V 的 电压 范 
围 。 构 建 电路 时 ， 可 以 从 4.7k 欧 姆 电阻 开始 ， 并 根 
据 需 要 更 改 它 们 。 











VCC 


LDR1 


R1 





== GND 


图 12-4 ”简单 感光 电路 的 示意 图 
12.4.2 Arduino 程 序 
现在 来 编写 Arduino 程 序 。 下 面 是 运行 在 


Arduino 上 的 代码 ， 让 它 从 电路 读 取 信号 ， 并 通过 
串口 将 它们 发 送 给 计算 机 : 





#include "Arduino.h" 


void setup() 
{ 


// initialize serial communications 
@ Serial.begin(9600); 
} 


void loop() 
{ 


// read AO 
int vali = analogRead(0); 
// read A1 
® int val2 = analogRead(1); 
// print to serial 
Serial.print(vali1); 
Serial.print(" "); 
Serial.print(val2); 
Serial.print("\n"); 
// wait 
delay(50); 


e 


-© 


在 @@ 行 ， 在 setup0 方 法 中 启用 串口 通信 。 因 为 
setup(O 仅 在 程序 启动 时 调用 ， 所 以 这 是 放置 所 有 初 
始 化 代码 的 好 地 方 。 这 里 将 串口 通信 的 波 特 率 GH 
上 度 ， 以 位 / 秒 为 单位 ) 初始 化 为 9600， 这 是 大 多 数 设 
备 的 默认 值 ， 对 你 的 任务 来 说 也 足够 快 了 。 


主要 代码 位 于 loop0 方 法 中 。 在 @ 行 ， 从 模拟 
S| FeO (范围 在 [0,1023] 中 的 一 个 10 位 整数 ) 读 取 当 
前 信号 值 ， 在 全 行 ， 从 引 脚 1 读 取 当前 信号 值 。 在 
人 @ 行 和 随后 几 行 ， 用 Serial.print0 将 值 发 送 给 计算 
机 ， 格 式 化 为 两 个 整数 ， 以 空格 分 隔 ， 后 跟 换行 
符 。 在 @@ 行 ， 用 delay0O 延 绥 操 作 指 定 的 时 间 ， 在 这 
里 是 50 毫 秒 ， 然 后 循环 重复 。 这 里 采用 的 值 决定 了 








AVR 微 控制 右 执 行 1oop(0) 方 法 的 速度 。 


为 了 将 程序 上 传 到 Arduino， 将 Arduino 连 接 到 
计算 机 ， 局 动 其 IDE， 并 局 动 一 个 新 项 目 。 然 后 在 
程序 窗口 中 输入 代码 ， 单 击 Verify 以 编译 代码 。IDE 
将 显示 所 有 和 语法 相关 的 错误 与 警告 。 如 果 一 切 正 
^, HihUpload ERR Arduino. WRES 
阶段 没有 看 到 任何 错误 ， 从 Arduino 软 件 的 工具 来 
单 中 调 出 串口 监视 占 ， 应 该 看 到 类 似 这 样 的 结果 : 








512 300 
513 280 
400 200 


这 些 是 从 模拟 引 脚 0 和 1 读 取 的 模拟 值 ， 并 通过 
Arduino 的 USB 口 串 行 发 送 给 计算 机 。 


12.4.3 ”创建 实时 图 表 


为 了 在 项 目 中 实现 滚动 的 实时 图 ， 需 要 使 用 一 
个 deque， 如 第 4 章 所 述 。deque 由 N 个 值 的 数组 构 
成 ， 在 任 一 问 添 加 和 删除 值 都 能 很 快 完 成 。 新 值 出 
现时 ， 它 们 被 添加 到 deque， 并 且 最 老 的 值 被 弹 
出 。 以 固定 间隔 绘制 这 些 值 ， 束 会 生成 实时 图 ， 其 
中 最 新 的 数据 总 是 在 左 侧 添加 。 























12.5 Python 代码 














现在 来 看 看 从 串口 读 取 数据 的 Python 程序 〈 完 
整 的 项 目 代 码 ， 请 跳 到 12.6 节 ) 。 为 了 更 好 地 组 织 
代码 ， 我 们 定义 一 个 类 AnalogPlot， 它 保存 要 绘制 
的 数据 。 下 面 是 该 类 的 构造 函数 : 


class AnalogPlot: 
# constructor 
def _ init (self, strPort, maxLen): 
# open serial port 
self.ser - serial.Serial(strPort, 9600) 


self.aoVals = deque([0.0]*maxLen) 
self.adVals = deque([0.0]*maxLen) 
self.maxLen - maxLen 


eoo © 


在 代行 ，AnalogPlot 的 构造 函数 利用 pySerial 库 
创建 一 个 Serial 对 象 。 我 们 将 用 该 类 与 Arduino 的 串 
口 通信 。Serial 构 造 函 数 的 第 一 个 参数 是 端口 名 称 
字符 串 ， 可 以 在 IDE 中 通过 选择 Tools Serial Port 找 
到 和 它 〈 在 Windows 上 ， 该 字符 串 类 似 于 COM3， 在 
Linux 和 OS XE, AUT /devitty.usbmodem411) © 
Serial 构 造 函 数 的 第 二 个 参数 是 波 特 率 ， 我 们 设置 
为 9600， 以 匹配 Arduino 程 序 中 设置 的 速率 。 


在 @ 行 和 人 @@ 行 ， 创 建 了 deque 对 象 来 保存 模拟 





值 。 我 们 使 用 大 小 为 maxLen 的 全 和 零 列 表 初 始 化 
deque 对 象 ， 这 是 在 给 定时 间 绘 制 的 值 的 最 大 数 
量 。 在 @@ 行 ， 这 个 maxLen 保 存在 AnalogPlot 对 象 
中 。 





为 了 实时 绘制 模拟 值 ， 我 们 用 deque 对 象 绥 冲 
最 近 的 值 ， 如 AnalogPlot 类 中 所 示 。 


# add data 
def add(self, data): 
assert(len(data) -- 2) 
e self.addToDeq(self.aO0Vals, data[0]) 
(2) self.addToDeq(self.aiVals, data[1]) 
# add to deque; pop oldest value 
def addToDeq(self, buf, val): 
e buf .pop() 
o buf .appendleft (val) 


正如 你 前 面 看 到 的 ，Arduino 每 行 仅 发 送 两 个 
模拟 整数 值 。 在 add0) 方 法 中 ， 在 @ 行 入行， 每 个 
模拟 引 脚 的 数据 值 都 用 addToDeq0 方 法 添加 到 两 个 
deque 对 象 中 。 在 候 行 和 人 @ 行 ， 这 个 方法 用 pop(0) 方 
法 从 deque 的 尾部 删除 最 老 的 值 ， 然 后 用 appendleftO) 
方法 将 最 新 的 值 汪 加 到 deque 的 头 部 。 在 绘制 来 自 
— 的 值 时 ， 最 新 的 值 始 终 显示 在 图 形 的 左 
则 。 


我 们 利用 matplotlib 的 animation 类 ， 以 设置 的 间 
隔 更 新 绘图 〈 你 可 能 还 记得 ， 在 第 5 章 的 Boids 项 目 








中 看 到 过 ) 。 下 面 是 AnalogPlot 中 的 update0) 方 法 ， 
它 将 在 绘制 动画 的 每 一 步 中 调用 : 


# update plot 
def update(self, frameNum, a0, a1): 
try: 
line - self.ser.readline() 
data - [float(val) for val in line.split()] 
# print data 
if(len(data) -- 2): 
self.add(data) 
aQ.set_data(range(self.maxLen), self.a0Vals) 
al.set_data(range(self.maxLen), self.aiVals) 
except: 
pass 


oo 


o O00 


return a0, al 


在 人 @ 行 ，update0 方 法 将 一 行 串口 数据 读 入 为 
一 个 字符 串 ， 在 信行 ， 利用 Python 的 列表 解析 ， 将 
值 转换 为 浮 点 数 ， 并 保存 在 列表 中 。 我 们 用 splitO 
方法 根据 空格 来 分 割 字 符 串 ， 以 便 将 串口 读 入 的 字 
符 串 512 600m 转 换 为 [512,600]。 


检 碍 数据 有 两 个 值 之 后 ， 在 个 行 用 AnalogPlot 
的 add0) 方 法 将 值 添 加 到 deque。 在 信行 和 人 @ 行 ， 利 
用 matplotlib 的 set_data() 方 法 ， 用 新 值 更 新 图 形 。 
次 绘图 的 x 值 是 一 系列 数字 [0，.… maxLen]， 用 
range() 方 法 设置 。y 值 用 更 新 的 deque 对 和 象 来 填充 。 


所 有 这 些 代码 都 包含 在 try 语 句 块 中 ， 如 果 发 生 
异常 ， 代 码 跳 转 到 @ 行 的 pass， 在 这 里 忽略 读 入 数 











Ya Cpass 个 做 任何 事情 ) 。 使 用 try 语 句 块 是 因为 ， 
串口 数据 有 时 可 能 因 电 路 中 接触 不 恨 而 损坏 ， 而 我 
们 不 希望 仅仅 因为 串口 发 送 了 一 些 坏 的 值 ， 程 序 束 
朋 尝 。 


准备 退出 时 ， 关 闭 串口 以 释放 所 有 系统 资源 ， 
如 下 上 所 示 : 
# clean up 
def close(self): 
# close serial 


self.ser.flush() 
self.ser.close() 


在 main() 方 法 中 ， 需 要 设置 matplotlib 动 画 : 


# set up animation 


@ fig = plt.figure() 

@ ax = plt.axes(xlim-(0, maxLen), ylim=(0, 1023)) 

O a0, = ax.plot([], []) 

© a1, = ax.plot([], []) 

® anim = animation.FuncAnimation(fig, analogPlot.update, 
fargs-(a0, ai), interval=20) 

# show plot 
@  plt.show() 


在 @ 行 ， 取 得 matplotlib 的 figure 模 块 ， 其 中 包 
含 所 有 的 绘图 元 素 。 在 贸 行 ， 访 问 axes 模 块 ， 设 置 
图 形 的 x 和 y 限 制 。x 限 制 是 样本 数 ，y 限 制 为 1023， 
因为 它 是 模拟 值 范围 的 上 限 。 


在 个 行 和 @@ 行 ， 创 建 两 个 空白 行 对 象 〈“a0 和 
al) ， 我 们 将 它们 传递 给 animation 类 来 设置 回调 ， 
为 每 一 行 提供 坐标 。 然 后 ， 在 人 @ 行 ， 传 入 在 每 个 动 
画 步 骤 中 要 调用 的 analogPlot update() 方 法 ， 来 设置 
动画 。 我 们 还 指定 了 调用 该 方法 的 参数 ， 以 及 以 坚 
秒 为 单位 的 时 间 间 隔 ， 这 里 是 20。 在 @@ 行 ， 调 用 
plt.show0 来 启动 动画 。 


程序 的 main0 方 法 也 是 用 Python 模 块 argparse 来 
文 持 命令 行 选项 的 地 方 。 


# create parser 


parser = argparse.ArgumentParser(description="LDR serial") 
# add expected arguments 
parser.add argument('--port', dest-'port', required-True) 
parser.add argument('--N', dest='maxLen', required-False) 


# parse args 
args - parser.parse args() 


strPort - args.port 


# plot parameters 
maxLen - 100 
if args.maxLen: 
maxLen - int(args.maxLen) 





--port 参 数 是 必需 的 。 它 告诉 程序 接收 数据 的 
串口 名 称 〈 在 Arduino IDE 中 的 Tools Serial Port F 
找到 ) 。maxLen 参 数 是 可 选 的 ， 用 于 设置 一 次 绘制 
的 点 数 〈 默 认 值 为 100 个 样本 ) 。 


12.6 ”完整 的 Python 代码 


下 面 是 这 个 项 目的 完整 Python 代码 。 也 可 以 从 
https://github.com/electronut/pp/tree/master/arduino- 
ldvldr.py 下 载 完整 的 代码 。 


import serial, argparse 

from collections import deque 

import matplotlib.pyplot as plt 

import matplotlib.animation as animation 


# plot class 
class AnalogPlot: 
# constructor 
def _ init (self, strPort, maxLen): 
# open serial port 
self.ser - serial.Serial(strPort, 9600) 


self.aoVals 
self.aiVals 
self.maxLen 


deque([0.0]*maxLen) 
deque([0.0]*maxLen) 
maxLen 


# add data 

def add(self, data): 
assert(len(data) == 2) 
self.addToDeq(self.aO0Vals, data[0]) 
self.addToDeq(self.aiVals, data[1]) 


# add to deque; pop oldest value 
def addToDeq(self, buf, val): 
buf .pop() 
buf.appendleft(val) 


# update plot 
def update(self, frameNum, a0, a1): 
try: 
line = self.ser.readline() 


data = [float(val) for val in line.split()] 

# print data 

if(len(data) == 2): 
self.add(data) 
a0.set data(range(self.maxLen), self.a0Vals) 
al.set_data(range(self.maxLen), self.aiVals) 

except: 
pass 


return a0, a1 


# clean up 

def close(self): 
# close serial 
self.ser.flush() 
self.ser.close() 


# main() function 
def main(): 
4 create parser 


parser = argparse.ArgumentParser(description="LDR serial") 
# add expected arguments 
parser.add argument('--port', dest-'port', required-True) 
parser.add argument('--N', dest='maxLen', required-False) 
# parse args 
args - parser.parse args() 


#strPort = '/dev/tty.usbserial-A7006Yqh' 
strPort = args.port 


print('reading from serial port %s...' 96 strPort) 


# plot parameters 
maxLen - 100 
if args.maxLen: 
maxLen - int(args.maxLen) 


# create plot object 
analogPlot - AnalogPlot(strPort, maxLen) 


print('plotting data...') 


# set up animation 

fig = plt.figure() 

ax = plt.axes(xlim=(0, maxLen), ylim-(0, 1023)) 
a0, - ax.plot([], []) 

al, = ax.plot([], []) 


anim = animation.FuncAnimation(fig, analogPlot.update, 
fargs-(a0, a1), interval-20) 


# show plot 
plt.show() 


# clean up 
analogPlot.close() 


print('exiting.') 
# call main 


if _name__ == ' main ': 
main( ) 


12.7 运行 程序 


要 测试 该 程序 ， 请 组 装 LDR 电 路 ， 将 Arduino 
连接 到 计算 机 ， 上 传 程序 ， 然 后 运行 Python 代码 。 


$ python3 --port /dev/tty.usbmodem411 ldr.py 





图 12-5 展 示 了 程序 的 输出 示例 ， 具 体 来 说 ， 是 
LDR 和 暴露 在 光 下 然后 窗 盖 时 生成 的 图 。 从 图 中 可 以 
看 出 ， 当 LDR 的 电阻 变化 时 ，Arduino 读 取 的 模拟 
电压 也 发 生变 化 。 中 心 的 高 峰 发 生 在 我 迅速 将 手 放 
在 LDR 上 时 ， 碳 侧 平 坦 部 分 发 生 在 我 较 慢 地 移 过 手 
时 。 























Figure 1 





zoo + rem 
图 12-5 ”光敏 绘图 程序 的 运行 示例 
这 两 个 LDR 具 有 不 同 的 电阻 特性 ， 这 就 是 两 条 
线 不 完全 重合 的 原因 ， 但 是 你 可 以 看 到 ， 它 们 以 相 
同 的 方式 对 光 强 的 变化 做 出 反应 。 


12.8 ”小 结 


这 个 项 目 介 绍 了 微 控制 器 和 Arduino 平 全 的 世 
界 。 我 们 学 习 了 Arduino 编 程 语 法 以 及 如 何 将 程序 
上 传 到 Arduino， 还 学 习 了 如 何 从 Arduino 引 脚 谈 取 
模拟 值 ， 并 创建 一 个 简单 的 LDR 电 路 。 此 外 ， 我 们 
学 习 了 如 何 通 过 串口 从 Arduino 发 送 数据 ， 并 使 用 
Python 从 计算 机 谍 取 数据 ， 还 学 习 了 使 用 实时 滚动 
图 和 matplotlib 让 数据 可 视 化 。 


12.9 ”实验 


请 尝试 对 Arduino 项 目 进 行 如 下 修改 。 


1. EFF, ABER, MELZ, 
新 值 从 左边 进来 时 ， 较 老 的 值 问 右 移动 。 请 反 转 滚 
动 方向 ， 使 图 形 从 右 同 元 移动 。 


2. Arduino 代 码 定期 读 取 模拟 值 ， 并 将 它们 发 
送 到 串口 。 输 入 数据 可 能 在 某 些 类 型 的 传感器 中 存 
在 波动 ， 和 常见 的 做 法 是 应 用 某 种 类 型 的 滤波 ， 从 而 
平滑 数据 。 请 实现 LDR 数 据 的 均值 策略 (提示 : 保 
存 每 个 LDR 读 取 的 N 个 模拟 值 的 移动 平均 值 ， 平 均 
值 应 定期 发 送 到 串口 。 减 少 循 环 中 的 delay()， 以 便 
更 快 地 读 取 值 。 均 值 图 比 原始 图 更 平滑 吗 ? 尝试 不 
同 的 N 值 ， 看 看 会 发 生 什 么 ) 。 


3. 传感器 电路 中 有 两 个 LDR。 保 持 这 些 LDR 
在 良好 的 光源 下 ， 从 它们 上 面 用 手 扫 过 。 你 应 该 看 
到 图 形 的 急剧 变化 : 一 个 LDR 曲 线 在 另 一 个 之 前 变 
化 ， 因 为 它 首 先 被 遮挡 。 可 以 用 这 些 信息 来 检测 手 
的 运动 方向 吗 ? 这 是 一 个 基本 的 手势 检测 项 目 〈 提 
示 : LDR 中 图 形 的 急剧 变化 发 生 在 不 同 的 时 间 ， 说 
明 哪 个 LDR 先 被 遮 责 ， 从 而 给 出 手 的 运动 方向 ) 。 

















第 13 章 ”激光 音乐 郁 





在 第 12 章 中， 我们 学 习 了 Arduino 的 基础 知 
识 ， 这 很 适合 与 确 层 电子 设备 接口 。 在 本 项 目 中 ， 
我 们 将 利用 Arduino 搭 建 便 件 ， 通 过 音频 信号 产生 
有 趣 的 激光 图 案 。 这 一 次 ，Python 会 承担 更 重 的 任 
务 。 除 了 处 理 串 口 通信 之 外 ， 它 还 会 基于 实时 音频 
a 

‘ JL. 


出 于 这 些 目的 ， 请 将 激光 当 作 一 束 强 烈 的 光 
束 ， 即 使 通过 很 大 距离 投射 ， 它 仍 保持 聚焦 在 一 个 
微小 的 点 上 。 这 种 聚焦 是 可 能 的 ， 因 为 光束 被 组 织 
成 光波 只 沿 一 个 方 同行 进 ， 且 彼此 同 相 。 这 个 项 目 





将 用 一 个 便宜 的 、 容 易 获 得 的 油光 笔 来 创建 激光 图 
案 ， 与 首 乐 同步 (或 任何 音频 输入 〉。 我 们 用 激光 
笔 和 两 个 连接 到 电机 的 旋转 镜 ， 来 构建 生成 有 趣 图 
案 的 硬件 。 我 们 用 Arduino 设 置 电 机 的 方向 和 旋转 

速度 ， 利 用 Python 通过 串口 来 控制 。Python 程 序 将 
读 取 首 频 输入 ， 分 析 它 ， 并 将 它 转换 为 电机 速度 和 
方向 数据 来 控制 电机 。 我 们 还 将 学 习 如 何 设置 电机 
的 速度 和 方向 ， 让 图 案 与 音乐 同步 。 


本 项 目 将 进一步 提升 你 的 Arduino 和 了 Python 知 
识 。 以 下 是 将 要 介绍 的 一 些 主题 ; 











。 用 激光 和 两 个 旋转 镜 产 生 有 趣 的 图 和 案 ; 

。 用 快速 傅立叶 变换 从 信号 中 获得 频率 信息 ; 
。 用 numpy 计 算 快 速 傅 里 叶 变 换 ， 

。 用 pyaudio 读 取 音 频数 据 ; 

。 在 计算 机 和 Arduino 之 间 设 置 串口 通信 ; 

+ Hi Arduino tz HAL. 
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为 了 在 此 项 目 中 生成 激光 图 案 ， 我 们 用 激光 笔 
和 两 个 镜子 连接 到 两 个 小 型 直流 电机 的 轴 上 ， 如 图 
13-1 所 示 。 如 果 你 平面 镜 〈 反 射 镜 A) 的 表面 照射 
激光 ， 即 使 电机 正在 旋转 ， 投 影 的 反射 将 保持 为 一 
个 点 。 因 为 激光 器 的 反射 平面 垂直 于 电机 的 旋转 
轴 ， 所 以 就 像 锐 子 根本 不 旋转 一 样 。 


现在 ， 假 设 镜子 与 轴 成 一 定 角 上 度 连接 ， 如 图 
13-1 右 侧 所 示 CREB) 。 当 轴 旋 转 时 ， 投 影 点 
的 轨迹 是 一 个 椭圆， 而 且 如 末 电 机 旋转 足够 快 ， 观 
察 者 会 感 党 到 移动 点 是 连续 的 形状 。 
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图 13-1 FHS CATA 反射 单个 点 。 倾 斜 的 镜子 〈 镜 子 
B) 的 反射 在 电动 机 旋转 时 产生 一 个 加 


WA RHET, EM FAB ISEB EEE 
TBE, RATE? 现在 当 电 机 A 和 电机 B 旋 转 时 ， 
由 反射 点 产生 的 图 案 将 是 电机 A 和 电机 B 的 两 个 旋 
转运 动 的 组 合 ， 产 生出 有 趣 的 图 案 ， 如 岁 13-2 所 
ZR o 








产生 的 图 案 将 取决 于 两 个 电机 的 旋转 速度 和 旋 
转 方向 ， 但 是 它们 类 似 于 在 第 2 章 中 探讨 的 万 花 尺 
产生 的 长 短 辐 圆 内 旋 轮 线 。 


13.1.1 电机 控制 





我 们 用 Arduino 来 控制 电机 的 速度 和 方向 。 这 
种 设置 要 小 心 ， 确 保 它 可 以 接受 电机 相对 较 高 的 电 
压 ， 因 为 Arduino 只 能 承担 这 么 大 的 电流 ， 人 否则 会 
损坏 。 可 以 用 图 13-3 (a) 所 示 的 SparkFun 
TB6612FNG 外 设 “ 分 线 (breakout) ” 板 来 保护 
Arduino， 人 简化 设计 并 缩短 开发 时 间 。 利 用 分 线 板 
从 Arduino 同 时 控制 两 个 电机 。 








电机 B 


图 13-2 ae. 倾斜 的 镜子 ， 产 生 了 有 趣 
J 复杂 图 案 


B6612FNC 


T 
Breakou t 





Xl13-3 SparkFun 电 机 驱动 器 1A 双 通道 TB6612FNG 


图 13-3 (b) 展示 了 分 线 板 的 焊接 背面 。 引 脚 
名 称 中 的 A 和 B 表 示 两 个 电机 。IN 引 脚 控 制 电机 的 
方向 ，01 和 02 引 脚 为 电机 供电 ，PWM 引 脚 控 制 电 
机 速度 。 通 过 写 入 这 些 引 脚 ， 你 可 以 控制 每 个 电机 
的 旋转 方向 和 速度 ， 而 这 正 是 本 项 目 需要 的 。 


可 以 用 任何 你 熟悉 的 电机 控制 电路 替换 该 分 线 板 部 分 ， 只 要 适 
当地 修改 Arduino 程 序 即 可 。 


13.1.2 ”快速 傅 里 叶 变 换 
因为 本 项 目的 最 终 目 标 是 基于 音频 输入 控制 电 





机 速度 ， 所 以 需要 能 够 分 析 首 频 的 频 座 。 


回顾 一 下 第 4 章 ， 来 自 乐器 的 音调 是 多 种 频率 
或 泛音 的 混合 。 事 实 上 ， 任 何 声音 都 可 以 用 传 立 叶 
变换 分 解 为 成 分 频率 。 将 傅 里 时 变换 应 用 于 数字 信 
号 时 ， 结 果 称 为 离散 傅 里 叶 变 换 CDFT) ， 因 为 数 
字 信 号 由 许多 离散 样本 组 成 。 在 本 项 目 中 ， 我 们 用 
Python 来 实现 快速 傅立叶 变换 FFT) 算法 ， 计 算 
DFT〔 在 本 间 中 ， 我 将 使 用 FFT 来 指 代 算 法 和 结 
R) 。 


下 面 是 一 个 简单 的 FFT 示 例 。 图 13-4 展 示 了 一 
个 只 包含 两 个 正弦 波 的 信和 号， 下面 是 对 应 的 FEFT。 
上 面 的 波 可 以 用 以 下 等 式 表示 ， 是 两 个 波 相 加 : 


y(t) = 4sin(2n10t) + 2.5sin(2n30t) 
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图 13-4” 从 音乐 中 记录 的 音频 信号 (上) 及 相应 的 FFT CR) 
请 注意 第 一 个 波 的 表达 式 中 的 4 和 10: 4 是 波 的 


振幅 ，10 是 波 的 频率 《以 蔡 效 为 单位 ) 。 同 时 ， 第 
二 个 波 的 振幅 是 2.5， 频 率 是 30。 


FFT 换 示 了 波 的 分 量 频 紊 及 其 相对 振幅 ， 显 示 
峰值 在 10 Hz 和 30 Hz。 第 一 个 峰值 的 强度 约 为 第 二 
个 峰值 的 强度 的 两 倍 。 


现在 来 看 一 个 更 复杂 的 例子 。 图 13-5 展 示 了 上 
面 的 音频 信号 ， 以 及 下 面相 应 的 FFT。 
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图 13-5 FEFT 算 法 利用 振幅 信号 CE) 计算 其 分 量 频率 (下) 


音频 输入 《或 信号 ) 处 在 “时 域 * 中 ， 因 为 振幅 
数据 随时 间 变 化 。FFT 处 在 “ 频 域 "中 。 注 意图 13-5 
中 ，FFT 显 示 了 一 系列 峰值 ， 显 示 了 信号 中 各 种 频 
率 的 强度 。 





要 计算 FFT， 需 要 一 组 样本 。 样 本 数 的 选择 是 
有 点 随意 的 ， 但 是 小 的 样本 规模 不 能 给 出 信和 号 频率 
特征 的 展 好 图 景 ， 还 可 能 意味 着 更 大 的 计算 量 ， 
为 每 秒 需 要 计算 更 多 的 FFT。 另 一 方面 ， 过 大 的 样 
本 规模 让 信号 的 变化 平均 化 ， 因 此 不 会 得 到 信号 
的 “实时 ”频率 啊 应 。 对 于 本 项 目 采 用 的 44100Hz 的 
采样 率 ，2048 的 样本 大 小 表示 大 约 0.046 秒 的 数据 。 


对 于 本 项 目 ， 我 们 需要 将 音频 数据 分 解 成 它 的 
组 成 频率 ， 并 用 该 信息 控制 电机 。 首 先 ， 将 频率 范 
围 〈 以 Hz 为 单位 ) 分 成 3 个 频段 : [0,100]、 
[100,1000] 和 [1000，2500]。 我 们 将 计算 每 个 频 市 的 
平均 振幅 ， 每 个 值 将 不 同 程度 地 影响 电机 和 产生 的 
激光 图 案 ， 如 下 所 示 : 








. 低频 平均 振幅 的 变化 将 影响 第 一 个 电机 的 
“ 中频 平均 拓 本 的 变化 将 影响 第 一 个 电机 的 
+ EMEC PRT. NAL 
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13.2 ”所 需 模 块 


以 下 是 构建 此 项 目 所 需 物品 的 列表 : 


。 一 文 小 油光 笔 ; 

。 两 个 直流 电动 机 ， 如 用 于 小 玩具 (额定 为 9V) 
的 电机 .; 

。 两 个 小 镜子 ， 直径 约 2.54 厘 米 或 更 小 ; 

。SparkFun 电 机 驱动 器 1A 双 通道 TB6612FNG:; 

。Arduino Uno 或 类 似 板 卡 ; 

。 〈 单 心 连接 线 ， 两 侧 的 公 插 针 工 作 

F); 

© VU TS AAFIbZH; 

。 —E RRR, OR FLAG EM RS ET 
起 ， 使 镜子 可 以 目 由 旋转 ; 

。 一 个 算 形 的 纸板 或 内 烯 酸 树脂 板 ， 约 20.3 厘 米 
x15.2 厘 米 ， 以 安装 便 件 ; 

© FE AURORE 

© KER. 


13.2.1 搭建 激光 夯 


第 一 件 事 是 将 镜子 连接 到 电机 。 反 则 镜 必须 与 
电机 轴 成 一 个 小 角度 。 要 安装 镜子 ， 将 其 面 基 下 放 





置 在 平坦 的 表面 上 ， 并 在 中 心 滴 一 滴 热 腕 。 小 心地 
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人 硬化 如 图 13-6 所 示 〉 。 要 测试 它 ， 就 用 手 旋转 镜 
子 ， 同 时 用 激光 笔 照 射 它 。 你 应 该 发 现 反 射 的 激光 
点 投 喘 在 平坦 表面 上 时 ， 移 动 轨迹 是 一 个 椭圆 中 。 
对 第 二 面 镜 子 也 一 样 操作 。 








图 13-6 ”以 微小 角度 将 反射 镜 连接 到 每 个 电机 轴 
对 准 镜子 

接 下 来 ， 将 激光 笔 与 反射 镜 对 准 ， 使 激光 从 反 
射 镜 A 反 射 到 B， 如 图 13-7 所 示 。 确 保 在 反射 镜 A 的 
整个 旋转 范围 内 ， 来 自 反 射 镜 A 的 反射 激光 保持 在 
反射 镜 B 的 圆周 内 〈 这 需要 一 些 和 党 试 ， 可 能 会 犯 些 
错 ) 。 要 测试 ， 请 手动 旋转 反射 镜 A。 另 外 ， 确 保 
在 两 个 反射 镜 的 旋转 范围 内 ， 反 射 镜 B 的 位 置 让 它 
反射 的 光 落 在 一 个 平面 上 《〈 如 墙 上 ) 。 
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图 13-7 ”激光 笔 和 反射 镜 的 对 准 








调整 时 ， 需 要 保持 激光 笔 打 开 。 如 果 激 光 笔 有 一 个 开局 按钮 ， 
请 用 胶带 让 它 保持 打开 《或 者 参见 13.8 节 ， 了 解 更 优雅 的 控制 激光 
笔 电 源 的 方法 ) 。 


对 镜子 的 位 置 感到 满意 后 ， 将 激光 笔 和 两 个 市 
有 镜子 的 电机 用 热 燃 胶 粘 到 3 个 一 样 的 乐高 模 堪 
上 ， 将 它们 升 起 ， 让 它们 能 够 自由 旋转 。 接 下 来 ， 
将 模 其 放 在 安 竣 板 上 ， 当 你 对 它们 的 摆 放 感到 满意 
时 ， 通 过 用 铬 笔记 录 和 它们 的 边缘 ， 标 记 每 个 模块 的 
位 置 。 然 后 将 模块 粘 在 板 上 。 


为 电机 供电 


如 果 电 机 没有 附带 连接 到 它们 的 端子 上 的 电线 
(大 多 数 没 有 ) ， 就 将 电线 焊接 到 两 个 端子 ， 确 保 
留 出 足够 的 电线 《例如 15 厘 米 ) ， 以 便 将 电机 连接 
到 电机 驱动 板 卡 上 。 电 机 由 电池 组 中 的 四 节 AA 电 
池 供 电 ， 可 以 用 热 炊 胶 将 它 烙 在 安装 板 的 背面 ， 如 
图 13-8 所 示 。 

现在 用 手 旋转 两 个 镜子 来 测试 硬件 ， 同 时 用 普 
光照 射 它们 。 如 有 果 足 够 快 地 旋转 它们 ， 应 该 看 到 一 
些 有 趣 的 图 案 ， 顷 见 结果 的 样子 ! 
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图 13-8 ”将 电池 组 固定 在 安装 板 背 面 
13.2.2 ”连接 电机 驱动 需 


本 项 目 用 Arduino 通 过 Sparkfun 电 机 驱动 需 
CTB6612FNGO 来 控制 电机 。 我 不 会 详细 介绍 这 个 
板 卡 的 工作 原理 ， 但 如 果 你 好 奇 ， 可 以 从 了 解 “H 





桥 ” 开 始 ， 这 是 一 种 沼 见 的 电路 设计 ， 用 “金属 氧化 
E ce (MOSFET) ”来 控制 电 
Jl. 








现在 将 电机 连接 到 SparkFun 电 机 驱动 器 和 
Arduino。 有 不 少 电线 要 连接 ， 如 表 13-1 所 示 。 一 个 
电机 标记 为 A， 男 一 个 为 B， 在 接线 时 遵守 这 个 惯 
例 。 


表 13-1 SparkFun 电 机 驱动 器 到 Arduino 的 接线 





|Arduino Digital Pin 3 TB6612FNG |Pin PWMA | 


Arduino 5V Pin TB6612FNG 
Arduino GND TB6612FNG 
Arduino GND Battery Pack 

Battery Pack VCC (+) TB6612FNG 


Motor #1 Connector #1 (polarity doesn’t matter) 
TB6612FNG 


Motor #1 Connector #2 (polarity doesn’t matter) 
TB6612FNG 


Motor #2 Connector #1 (polarity doesn’t matter) 
TB6612FNG 


Motor #2 Connector #2 (polarity doesn’t matter) 
TB6612FNG 


Arduino USB connector 





图 13-9 展 示 了 上 所 有 接线 。 





图 13-9 ”完全 连 好 线 的 激光 秀 装 置 
现在 来 看 看 Arduino 程 序 。 


13.3 Arduino 程 序 


程序 开始 时 ， 设 置 Arduino 的 数字 输出 引 脚 。 
然后 ， 在 主 循环 中 ， 从 串口 访 入 数据 ， 并 将 数据 转 
换 为 需要 友 送 到 电机 驱动 器 板 卡 的 参数 。 我 们 还 要 
了 解 如 何 实现 电 机 的 速度 和 方 同 控制 |。 


13.3.1 配置 Arduino 数 字 输 出 引 脚 


首先 ， 根 据 表 13-1 将 Arduino 数 字 引 脚 映 射 到 
电机 了 驱动 右上 的 引 脚 ， 并 将 引 脚 设置 为 输出 。 





// motor A connected to A01 and A02 
// motor B connected to BO1 and B02 


@ int STBY = 10; //standby 


// Motor A 

int PWMA - 3; //speed control 
int AIN1 = 9; //direction 

int AIN2 = 8; //direction 


// Motor B 

int PWMB = 5; //speed control 

int BIN1 = 11; //direction 
int BIN2 = 12; //direction 


void setup(){ 
&  pinMode(STBY, OUTPUT); 
pinMode(PWMA, OUTPUT); 


pinMode(AIN1, OUTPUT); 
pinMode(AIN2, OUTPUT); 


pinMode(PWMB, OUTPUT); 
pinMode(BIN1, OUTPUT); 
pinMode(BIN2, OUTPUT); 


// initialize serial communication 
© Serial.begin(9600); 
} 


从 @ 行 到 @ 行 ， 将 Arduino 引 脚 的 名 称 映 射 到 
电机 驱动 器 引 脚 。 例 如 ，PWMA (脉冲 调制 A) 控 
制 电 机 A 的 速度 ， 并 分 配给 Arduino 引 脚 3。PWM 是 
为 设备 供电 的 一 种 方式 ， 通 过 发 送 快速 打开 和 关闭 
的 数字 脉冲 ， 让 器 件 “ 看 到 ”连续 的 电压 。 数 字 脉 冲 
接 通 的 时 间 部 分 称 为 “ 占 空 比 ”"， 以 百分比 表示 。 通 
过 更 改 这 个 百分比 ， 可 以 为 设备 提供 不 同 的 功率 水 
^F. PWM 通 常用 于 控制 可 调 光 LED 和 电机 速度 。 

然后 ， 在 全 行 调 用 setup0 方 法 ， 在 后 续 几 行 
中 ， 将 所 有 7 个 数字 引 脚 设置 为 输出 。 在 人 @@ 行 ， 开 
始 串 口 通信 ， 读 取 由 Arduino 上 的 计算 机 发 送 的 串 
行 数据 。 

13.3.2 EJEA 
程序 中 的 主 循环 等 待 串 行 数据 到 达 ， 解 析 它 以 


提取 电机 速度 和 方 同 ， 并 利用 该 信息 来 设置 控制 电 
机 的 驱动 板 的 数字 输出 。 


// main loop that reads the motor data sent by laser.py 


void loop() 
{ 


e 
e 
e 


// data sent is of the form 'H' (header), speedi, diri, sf 
if (Serial.available() >= 5) { 


if(Serial.read() == 'H') { 

// read the next 4 bytes 

byte s1 = Serial.read(); 

byte di = Serial.read(); 

byte s2 = Serial.read(); 

byte d2 = Serial.read(); 

// stop the motor if both speeds are © 
if(s1 == 0 && s2 == 0) { 

stop(); 
else { 


// set the motors' speed and direction 
move(0, si, di); 
move(1, s2, d2); 


// slight pause for 20 ms 
delay(20); 


else { 
// if there is invalid data, stop the motors 


else { 


stop(); 


// if there is no data, pause for 250 ms 
delay(250); 


电机 控制 数据 以 5 个 字 市 为 一 组 友 送 : HJR ERA 


个 单字 节 数 字 s1、d1、s2 和 d2， 表 示 电 机 的 速度 和 
oan 由 于 串 行 数据 连续 输入 ， 所 以 在 @ 行 ， 检查 
并 确保 已 收 到 至 少 5 个 字 节 。 如 果 没 有 ， 就 延 人 运 250 


zP, JJ 


试 在 下 一 个 周期 中 再 次 读 取 数 据 。 


在 鳞 行 ， 检 碍 读 入 的 第 一 个 字 节 是 一 个 H， 以 
确保 在 一 组 正确 的 控制 数据 的 开始 处 ， 接 下 来 的 4 
个 字 节 是 期 望 的 数据 。 如 果 不 是 ， 就 在 人 @ 行 停止 电 
机 ， 因 为 数据 可 能 因 传 输 或 连接 错误 而 被 损坏 。 


从 全 行 开始 ， 程 序 读 取 两 个 电机 的 速度 和 方 问 
数据 。 如 果 两 个 电机 速度 都 设置 为 零 ， 吏 停止 电机 
四 如 果 不 是 ， 则 在 四 行 用 move0) 方 法 将 速度 和 方 
问 值 分 配给 电机 。 在 @@ 行 ， 在 数据 读 取 中 添加 一 个 
小 延迟 ， 让 电机 能 跟 上 ， 确 保 没 有 太 快 地 读 入 数 
据 。 


下 面 是 用 于 设置 电机 速度 和 方 同 的 move0) 方 
i: 





// set motor speed and direction 
// motor: A -> 1, B -> 0 
// direction: 1/0 
void move(int motor, int speed, int direction) 
{ 
// disable standby 
@ digitalwrite(STBY, HIGH); 
€ boolean inPini = LOW; 
boolean inPin2 - HIGH; 
® if(direction == 1){ 
inPini = HIGH; 
inPin2 - LOW; 
} 


if(motor == 1) 
@ digitalwrite(AIN1, inPin1); 
digitalWrite(AIN2, inPin2); 
analogwrite(PWMA, speed); 


else{ 
® digitalwrite(BIN1, inPin1); 
digitalWrite(BIN2, inPin2); 
analogwrite(PWMB, speed); 


j 





电机 驱动 器 具有 待机 模式 ， 以 便 在 电机 关闭 时 
节省 电力 。 在 @ 行 ， 通 过 写 入 HIGH 到 待机 引 脚 ， 
退出 待机 。 在 人 信行， 定义 两 个 布尔 变量 ， 它 们 确定 
电机 的 旋转 方 同 。 在 全 行 ， 如 果 direction 参 数 设 置 
为 1， 则 翻转 这 些 变 量 的 值 ， 这 让 你 在 下 面 的 代码 
中 切换 电机 的 方向 。 


在 @ 行 ， 为 电机 A 设置 引 脚 AIN1、AIN2 和 和 
PWMA。 引 脚 AIN1 和 AIN2 控 制 电 机 的 方向 ， 根 据 
需要 ， 我 们 用 Arduino 的 digitalWrite0) 方 法 将 一 个 引 
脚 设 置 为 HIGH (1) ， 一 个 设置 为 LOW (0) 。 对 
于 引 脚 PWMA， 我 们 发 送 PWM 信 号 ， 如 前 所 述 ， 
这 可 以 控制 电机 的 速度 。 要 控制 PWM 的 值 ， 可 以 
用 analogWirite() 方 法 将 范围 [0,255] 内 的 值 写 入 
Arduino 输 出 引 脚 (不 同 的 是 ，digitalWrite() 方 法 只 
允许 将 1 或 0 写 入 输出 引 脚 ) 。 


在 @ 行 ， 设 置 电 机 B 的 引 脚 。 
1333 停止 电机 
要 停止 电机 ， 将 LOW 写 入 电机 驱动 器 的 待机 








引 脚 。 


void stop(){ 
//enable standby 
digitalwrite(STBY, LOW); 


13.4 Python 代码 








现在 来 看 看 在 计算 机 上 运行 的 Python 代码 。 这 
段 代 码 完成 了 繁重 的 工作 : 它 读 入 音频 ， 计 算 
FFT， 并 发 送 串 行 数据 到 Arduino。 可 以 在 13.5 节 中 
找到 完整 的 项 目 代 码 。 


13.4.1 选择 音频 设备 


首先 ， 需 要 利用 pyaudio 模 块 读 入 音频 数据 。 
初始 化 pyaudio 模 块 如 下 : 


p = pyaudio.PyAudio() 


接 下 来 ， 可 以 用 pyaudio 中 的 辅助 函数 访问 计 
算 机 的 音频 输入 设备 。getInputDevice() 方 法 的 代码 
如 下 上 所 示 : 


# get pyaudio input device 

def getInputDevice(p): 

@ index = None 

@ nDevices = p.get_device_count() 


print('Found %d devices. Select input device:' % nDevices) 
# print all devices found 
for i in range(nDevices): 

e deviceInfo - p.get device info by index(i) 


o devName - deviceInfo['name'] 
® print("%d: %s" % (i, devName)) 
# get user selection 
try: 
# convert to integer 
O index = int(input()) 
except: 
pass 


# print the name of the chosen device 
if index is not None: 
devName = p.get_device_info_by_index(index)["name"] 
print("Input device chosen: %s" % devName) 
Q return index 





EOT, BindxTEWXK ENNone (Zindex Æ 
@@ 行 的 函数 返回 值 ， 如 果 返 回 为 None， 则 表明 找 不 
到 合适 的 输入 设备 ) 。 在 信行 ， 用 
get_device_count(0) 方 法 获取 计算 机 上 音频 设备 的 数 
量 ， 包 括 所 有 首 频 人 硬件， 如 麦 元 风 、 线 路 输入 或 线 
Bun. 然后 表 历 所 有 找到 的 设备 ， 获 取 每 个 设备 


GT H'Jget device info by. indexQ X Zi [n] — 
个 字典 ， 其 中 包含 每 个 音频 设备 的 各 种 特征 信息 ， 
但 我 们 只 想 查 看 设备 的 名 称 ， 因 为 我 们 正在 但 找 输 
入 设备 。 在 人 @ 行 ， 保 存 设备 名 称 ， 在 全 行 ， 打 印 出 
设备 的 索引 和 名 称 。 在 @@ 行 ， 利 用 input0) 方 法 读 入 
用 户 的 选择 ， 将 读 入 的 字符 串 转 换 为 整数 索引 。 在 
人 @O 行 ， 这 个 选 定 的 索引 从 函数 返回 。 


13.4.2 ”从 输入 设备 读 取 数据 





选择 输入 设备 后 ， 需 要 从 中 读 取 数据 。 为 此 ， 
我 们 先 打 开 普 频 流 ， 如 下 所 示 〈 注 意 ， 所 有 的 代码 
在 while 循 环 中 连续 执行 ) 。 


4 set FFT sample length 
@ fftLen = 2**11 
# set sample rate 
@ sampleRate = 44100 
print('opening stream...') 
® stream = p.open(format = pyaudio.paInti6, 
channels = 1, 
rate = sampleRate, 
input = True, 
frames_per_buffer = fftLen, 
input device index = inputIndex) 


在 @ 行 ， 将 FFT 绥 冲 区 的 长 度 ( 用 于 计算 FFT 
的 音频 采样 数 ) 设置 为 2048 (是 211，FFT 算 法 针对 
2 的 罕 进 行 了 优化 )。 然 后 ， 将 pyaudio 的 采样 率 设 
置 为 44100， 即 44.1 kHz 信 ， 这 是 CD 质量 录音 的 标 
HE 
项 : 


。pyaudio.paInt16 表 示 读 取 的 数据 作为 16 位 整数 ， 

。channels 设 置 为 1， 因 为 我 们 将 音频 作为 单个 频 
Ie we HY; 

。rate 设 置 为 选 定 的 采样 速率 44100 Hz; 


。input 设 置 为 True; 

« frames_per_bufferix A FFT X KJ; 

e input device indexix & AKA TE getInputDevice() 
方法 中 选择 的 设备 。 


1343 ”计算 数据 流 的 FFT 
以 下 是 从 流 中 读 取 数据 的 代码 : 


# read a chunk of data 
e data = stream.read(fftLen) 
# convert the data to a numpy array 


dataArray = numpy.frombuffer(data, dtype=numpy.int16) 


在 @ 行 ， 从 音频 输入 流 读 取 最 近 的 fftLen 样 
本 。 然 后 在 信行 ， 将 该 数据 转换 为 16 位 整数 humpy 
数组 。 


现在 计算 这 个 数据 的 FFT。 


# get FFT of data 


e fftVals - numpy.fft.rfft(dataArray)*2.0/fftLen 
# get absolute values of complex numbers 
(2) fftVals = numpy.abs(fftVals) 


EQT, Hnumpy ft 模块 中 的 rfft0 方 法 ， 计 算 
numpy 数 组 中 的 值 的 FFT。 该 方法 接受 由 “ 实 
数 ”( 如 首 频 数据 〉 组 成 的 信号 并 计算 FFT， 通 第 结 








果 是 一 组 “复数 ”。2.0/fftLen 是 归 一 化 因子 ， 用 来 将 
FFT 值 映射 到 希望 的 范围 。 然 后 ， 因 为 rfft0) 方 法 返 
回复 数 ， 所 以 使 用 numpy 的 abs0) 方 法 候 来 获取 这 些 
复数 的 大 小 ， 它 是 实数 。 


13.4.4 从 FEFT 值 提取 频率 信息 
接 下 来 ， 从 FFT 值 中 提取 相关 的 频率 信息 。 


4 average 3 frequency bands: 0-100 Hz, 100- 
1000 Hz, and 1000-2500 Hz 
levels - [numpy.sum(fftVals[0:100])/100, 
numpy.sum(fftVals[100:1000])/900, 
numpy.sum(fftVals[1000:2500])/1500] 


为 了 分 析 音 频 信 号 ， 我 们 将 频率 范围 分 为 3 个 
频段 :0 至 100 Hz, 100221000 ”Hz 和 1000 至 2500 
Hz。 我 们 最 感 兴趣 的 是 较 低 的 低音 频段 〈0-100 
Hz) 和 中 音 〈100-1000 Hz) 频段 ， 分 别 大 致 对 应 
于 一 首 歌曲 中 的 节拍 和 人 声 。 对 于 每 个 范围 ， 我 们 
在 代码 中 用 numpy.sum0 〇 方法 计算 平均 FFT 值 。 


13.4.5 ”将 频率 转换 为 电机 速度 和 方 问 
现在 将 该 频率 信息 转换 为 电机 速度 和 方 问 。 














# 'H' (header), speedi, diri, speed2, dir2 
e vals - [ord('H'), 100, 1, 100, 1] 

# speedi 
(2) vals[1] = int(5*levels[0]) % 255 


# Speed2 


e vals[3] = int(100 + levels[1]) 96 255 
# dir 
di = 0 
@ if levels[2] > 0.1: 
d1 = 1 
vals[2] = d1 
O vals[4] = 0 


在 人 @ 行 ， 初 始 化 要 发 送 到 Arduino 的 电机 速度 
和 方 同 值 的 列表 5 个 字 节 ， 从 FH 开始， 前 面 讨论 
X) 。 用 内 置 ord0 函 数 将 字符 串 转 换 为 整数 ， 然 后 
ee 电机 速度 和 方向 ， 填 充 
该 列表 。 


EZ 


VER 


这 部 分 确实 是 自由 发 挥 ， 没 有 特别 优雅 的 规则 来 管理 这 些 转 
换 。 这 些 值 随 着 音频 信号 而 不 断 变化 ， 你 提出 的 任何 方法 都 可 以 改 
变 电 机 速度 ， 并 随 音乐 一 起 影响 激光 模式 。 只 需 确保 转换 将 电机 束 
度 设置 在 [0,255] 范 围 内 ， 并 且 方 向 总 是 设置 为 1 或 0。 我 选择 的 方法 
只 是 基于 试验 和 错误 ， 我 在 播放 各 种 类 型 的 音乐 时 观察 FFT 值 。 
在 铺 行 ， 从 最 低频 率 范 围 获取 值 ， 放 大 5 倍 ， 

转换 为 整数 ， 并 用 取 模 运算 符 CO 确保 该 值 位 于 

[0,255] 范 围 内 。 该 值 控 制 第 一 电机 的 速度 。 在 合 

行 ， 将 中 间 频 率 值 加 上 100， 并 放 在 [0,255] 范 围 

内 。 该 值 控制 第 二 电机 的 速度 。 


Ar, EOI, HERO YU ELA EUERORT B 
值 0.1， 束 切换 电机 A 方 同 。 电 机 B 的 方 同 保持 为 














0G (通过 尝试 和 错误 ， 我 发 现 ， 这 些 方法 产生 很 
好 的 图 案 变 化 ， 但 我 建议 你 改变 这 些 值 ， 并 创建 日 
己 的 转换 。 这 里 没有 错误 的 答案 ) 。 

13.4.6 ”测试 电机 设置 


在 用 实时 首 频 流 测 试 硬 件 之 前 ， 先 检查 电机 设 
置 。 这 里 展示 的 autoTestO0 函 数 就 是 做 这 件 事 的 : 





# automatic test for sending motor speeds 
def autoTest(ser): 
print('starting automatic test...') 
try: 
while True: 
# for each direction combination 
for dr in [(0, ©), (1, ©), (©, 1), (1, 1)]: 
# for a range of speeds 
for j in range(25, 180, 10): 
for i in range(25, 180, 10): 
vals - [ord('H'), i, dr[0], j, dr[1]] 
print(vals[1:]) 
data - struct.pack('BBBBB', *vals) 
ser.write(data) 
sleep(0.1) 
except KeyboardInterrupt: 
print('exiting...') 
# shut off motors 
e vals - [ord('H'), 60, 1, 60, 1] 
data - struct.pack('BBBBB', *vals) 
ser.write(data) 
ser.close() 


SOOO © 


该 方法 通过 改变 每 个 电机 的 速度 和 方 同 ， 让 两 
个 电机 在 一 定 范 围 内 运动 。 因 为 每 个 电动 机 的 方 癌 
可 以 是 顺 时 针 或 逆 时 针 ， 所 以 在 @@ 行 的 外 层 循环 中 


表示 4 个 这 样 的 组 合 。 对 于 每 种 组 合 ， 信 行 和 全 行 
的 循环 以 不 同 的 速度 运转 电机 。 


SEE 


我 使 用 范围 (25, 180, 10) ， 这 意味 着 速度 从 25 变 到 180， 步 
长 为 10。 我 没有 用 电机 的 完整 运动 范围 [0，255]， 因 为 电机 很 少 转 
速 低 于 25， 而 200 以 上 的 转速 真 的 很 快 。 


在 例 行 ， 生 成 5 字 市 的 电机 数据 值 ， 在 信行， 
打印 它们 的 方 回 和 速度 值 〈 使 用 Python 字 符 串 切割 
[1: ] 将 获得 除 列表 中 的 第 一 个 元 系 之 外 的 所 有 

容 ) 。 


在 @@ 行 ， 将 电机 数据 打包 到 字 节 数组 中 ， 并 在 
@ 行 将 其 写 入 串口 。 按 Ctrl-C 键 中 断 这 个 测试 ， 在 
全 行 通过 清理 来 处 理 这 个 异常 ， 停 止 电机 并 关闭 串 
口 ， 像 你 这 样 负 员 的 程序 员 虱 会 这 么 做 。 


13.4.7 命令 行 选项 


与 以 前 的 项 目 一 样 ， 可 以 用 argparse 模 块 来 解 
析 程 序 的 命令 行 参数 。 














# main method 
def main(): 
# parse arguments 


parser - argparse.ArgumentParser(description-'Analyzes audio 
sends motor control information via serial port') 
add arguments 


parser.add argument('-- 

port', dest-'serial port name', required=True) 
parser.add argument('-- 

mtest', action-'store true', default-False) 
parser.add argument('-- 

atest', action-'store true', default-False) 
args - parser.parse args() 





ESR, TE XE 
有 两 个 可 选 的 命令 行 选项 ， 一 个 用 于 自动 测试 (前 
面 介绍 过 ) ， 另 一 个 用 于 手动 测试 ( 稍 后 将 讨 


£5. 


下 面 是 main0 方 法 中 解析 命令 行 选项 后 友 生 的 


# open serial port 
strPort = args.serial port name 
print('opening ', strPort) 
@ ser = serial.Serial(strPort, 9600) 
if args.mtest: 
manualTest(ser) 
elif args.atest: 
autoTest(ser) 
else: 
eo fftLive(ser) 








在 @ 行 ， 利 用 pySerial 用 传 入 程序 的 字符 串 打 
开 一 个 串口 。 串 行 通 信 的 速度 或 波 特 率 设 置 为 每 秒 
9600 位 。 如 果 没 有 使 用 其 他 命令 参数 〈--atest 或 -- 
mtest) ， 则 在 信行 继续 首 频 处 理 和 FFT 计 算 ， 这 封 
装 在 fftLive() 方 法 中 。 








13.4.8 手动 测试 


这 个 手动 测试 允许 你 输入 特定 的 电机 方 回 和 速 
度 ， 以 便 看 到 它们 对 激光 图 案 的 影响 。 











# manual test of motor direction and speeds 
def manualTest(ser): 
print('starting manual test...') 
try: 
while True: 


print('enter motor control info such as < 100 1 120 © >') 
e strIn - raw input() 
(2) vals = [int(val) for val in strIn.split()[:4]] 
e vals.insert(0, ord('H') 
o data = struct.pack('BBBBB', *vals) 
® ser.write(data) 
except: 
print('exiting...') 
# shut off the motors 
vals = [ord('H'), 0, 1, 0, 1] 
data = struct.pack('BBBBB', *vals) 


© 


ser.write(data) 
ser.close() 


在 @ 行 ， 用 raw_input0 方 法 等 待 ， 直 到 用 户 在 
命令 提示 符 下 输入 值 。 预 期 输入 的 形式 为 100 1 120 
0， 表 示 电 机 A 的 速度 和 方向 ， 然 后 是 电机 也 的 速度 
和 方 同 。 在 信行 ， 将 字符 串 解 析 为 整数 列表 。 在 合 
行 ， 插 入 一 个 “H” 构 成 完整 的 电机 数据 ， 在 介 行 和 
命 行 ， 打 包 此 数据 并 通过 串口 以 预期 的 格式 发 送 。 
如 果 用 户 用 Ctrl-C 中 断 测试 〈 或 者 发 生 任 何 异 
常 ) ， 就 在 @ 行 完成 清理 工作 ， 正 常 关 闭 电 机 和 串 
O. 











13.5 ”完整 的 Python 代码 


下 面 是 本 项 目的 完整 的 Python 代码 。 也 可 以 在 
https://github.com/electronut/pp/tree/master/arduino- 
laser/laser.py 找 到 它 。 


import sys, serial, struct 
import pyaudio 

import numpy 

import math 

from time import sleep 
import argparse 


# manual test of motor direction speeds 
def manualTest(ser): 
print('staring manual test...') 
try: 
while True: 


print('enter motor control info: eg. < 100 1 120 © >') 
strIn = raw input() 
vals - [int(val) for val in strIn.split()[:4]] 
vals.insert(0, ord('H')) 
data - struct.pack('BBBBB', *vals) 
ser.write(data) 
except: 
print('exiting...') 
# shut off motors 
vals = [ord('H'), 0, 1, 0, 1] 
data - struct.pack('BBBBB', *vals) 
ser.write(data) 
ser.close() 
# automatic test for sending motor speeds 
def autoTest(ser): 
print('staring automatic test...') 
try: 
while True: 
# for each direction combination 


for dr in [(0, 9), (1, ©), (©, 1), (1, 1)]: 
# for a range of speeds 
for j in range(25, 180, 10): 
for i in range(25, 180, 10): 
vals - [ord('H'), i, dr[0], j, dr[1]] 
print(vals[1:]) 
data - struct.pack('BBBBB', *vals) 
ser.write(data) 
sleep(0.1) 
except KeyboardInterrupt: 
print('exiting...') 
# shut off motors 
vals = [ord('H'), 0, 1, 0, 1] 
data - struct.pack('BBBBB', *vals) 
ser.write(data) 
ser.close() 


# get pyaudio input device 
def getInputDevice(p): 
index - None 
nDevices - p.get device count() 


print('Found %d devices. Select input device:' % nDevices) 
# print all devices found 
for i in range(nDevices): 
deviceInfo - p.get device info by index(i) 
devName = deviceInfo[ 'name' ] 
print("%d: 96s" 96 (i, devName)) 
# get user selection 


try: 
# convert to integer 
index - int(input()) 
except: 


pass 


# print the name of the chosen device 

if index is not None: 
devName = p.get device info by index(index)["name"] 
print("Input device chosen: 96s" 96 devName) 

return index 


# FFT of live audio 

def fftLive(ser): 
# initialize pyaudio 
p = pyaudio.PyAudio() 


# get pyAudio input device index 
inputIndex = getInputDevice(p) 


# set FFT sample length 
fftLen - 2**11 

# set sample rate 
sampleRate - 44100 


print('opening stream...') 
stream = p.open(format = pyaudio.paInt16, 
channels - 1, 
rate = sampleRate, 
input - True, 
frames per buffer - fftLen, 
input device index - inputIndex) 
try: 
while True: 
# read a chunk of data 
data - stream.read(fftLen) 
# convert to numpy array 


dataArray = numpy.frombuffer(data, dtype=numpy.int16) 
# get FFT of data 
fftVals - numpy.fft.rfft(dataArray)*2.0/fftLen 
# get absolute values of complex numbers 
fftVals - numpy.abs(fftVals) 
4 average 3 frequency bands: 0-100 Hz, 100- 
1000 Hz and 1000-2500 Hz 
levels - [numpy.sum(fftVals[0:100])/100, 
numpy.sum(fftVals[100:1000])/900, 
numpy.sum(fftVals[1000:2500])/1500] 


# the data sent is of the form: 
# 'H' (header), speedi, diri, speed2, dir2 
vals - [ord('H'), 100, 1, 100, 1] 


4 speedi 
vals[1] = int(5*levels[0]) 96 255 
# speed2 
vals[3] = int(100 + levels[1]) % 255 
# dir 
di = 0 
if levels[2] » 0.1: 
di = 1 
vals[2] = d1 
vals[4] = 0 
# pack data 


data - struct.pack('BBBBB', *vals) 


# write data to serial port 
ser.write(data) 
# a slight pause 
sleep(0.001) 
except KeyboardInterrupt: 
print('stopping...') 
finally: 
print('cleaning up') 
stream.close() 
p.terminate() 
# shut off motors 
vals = [ord('H'), 0, 1, 0, 1] 
data = struct.pack('BBBBB', *vals) 
ser.write(data) 
# close serial 
ser.flush() 
ser.close() 


# main method 
def main(): 
# parse arguments 


parser = argparse.ArgumentParser(description-'Analyzes audio 
sends motor control information via serial port') 
# add arguments 
parser.add argument('-- 
port', dest-'serial port name', required-True) 
parser.add argument('-- 
mtest', action-'store true', default-False) 
parser.add argument('-- 
atest', action-'store true', default-False) 
args - parser.parse args() 


# open serial port 
strPort - args.serial port name 
print('opening ', strPort) 
ser - serial.Serial(strPort, 9600) 
if args.mtest: 
manualTest(ser) 
elif args.atest: 
autoTest(ser) 
else: 
fftLive(ser) 


# call main function 
if name == ' main ': 
main() 


13.6 ”运行 程序 


为 了 测试 本 项 目 ， 请 组 装 硬件 ， 将 Arduino 连 
接 到 计算 机 ， 并 将 电机 驱动 程序 代码 上 传 到 
Arduino。 确 保 电 池 组 已 连接 ， 激 光 笔 已 打开 并 投 
射 在 墙壁 这 样 的 平坦 表面 上 。 我 建议 首先 通过 运行 
以 下 程序 来 测试 激光 显示 部 分 (不 要 在 记 更 改 串 口 
字符 串 以 符合 你 的 计算 机 ) ! 





$ python3 laser.py --port /dev/tty.usbmodem411 --atest 
('opening ', '/dev/tty.usbmodem1411') 

staring automatic test... 

[25, ©, 25, 0] 

[35, 0,.25, 0] 

[45, 0, 25, 0] 


该 测试 通过 速度 和 方 同 的 各 种 组 合 来 运转 两 个 
电机 。 你 应 该 看 到 投射 到 墙 上 的 不 同 激光 图 案 。 要 
停止 程序 和 电机 ， 请 按 Ctrl-C。 

SRM AA, WAT ATP ee IEG J 
在 计算 机 上 开始 播放 你 喜欢 的 音乐 ， 然 后 运行 程序 
如 下 。《 同 样 ， 注 意 串 口 字 符 串 ! ) 











$ python3 laser.py --port /dev/tty.usbmodem411 


('opening ', '/dev/tty.usbmodem1411') 
Found 4 devices. Select input device: 
: Built-in Microph 

: Built-in Output 

: BoomDevice 

: AirParrot 


O@NDHO 


Input device chosen: Built-in Microph 
opening stream... 





你 应 该 看 到 激光 秀 产 生 了 许多 有 趣 的 图 案 ， 随 
着 音乐 和 时 间 变 化 ， 如 图 13-10 所 示 。 








图 13-10 ”激光 秀 的 完整 布线 和 投影 在 场 上 的 图 案 





137 VES 


本 章 通 过 构建 一 个 较 复 杂 的 项 目 ， 来 提升 你 的 
Python 和 Arduino 技 能 。 你 学 习 了 如 何 使 用 Python 和 
Arduino 控 制 电机 ， 用 numpy 来 获得 音频 数据 的 
FFT， 控 制 串口 通信 ， 甚 至 是 激光 ! 





138 ”实验 


下 面 是 修改 此 项 目的 一 些 方法 。 


1， 该 程序 采用 一 种 目 由 发 挥 的 方案 将 FFT 值 
转换 为 电机 速度 和 方 网 数据 。 请 符 试 修改 此 方案 。 
1e TD 


2. 在 本 项 目 中 ， 从 音频 信号 收集 的 频率 信息 
被 转换 为 电机 速度 和 方向 。 请 尝试 根据 音乐 的 整 
体 “ 节 和 雪 ? 或 音量 来 让 电机 和 运动。 为 此 ， 你 可 以 计算 
信号 幅度 的 “ 均 方 根 (RMS) ” 值 。 该 计算 类 似 于 
FFT 计 算 。 恋 入 一 组 音频 数据 并 放 入 numpy 数 组 x 
后 ， 可 以 按 如 下 方式 计算 RMS 值 : 








rms = numpy.sqrt(numpy.mean(x**2)) 


此 外 ， 回 忆 一 下 ， 项 目 中 振幅 表示 为 16 位 有 符 
号 整数 ， 其 最 大 值 为 32768 (一 个 要 记 住 的 有 用 数 
字 ， 用 于 标准 化 )。 用 这 个 RMS 振 幅 与 FFT 结 合 ， 
让 激光 图 案 产 生 更 大 的 变化 。 


在 项 目 中 ， 我 们 比较 朴素 地 用 了 一 些 胶 带 来 你 





持 油 光 笔 的 打开 状态 ， 测 试 并 进行 硬件 设置 。 能 找 
到 更 好 的 方法 来 控制 激光 吗 ? 请 阅读 光 隔 离 器 和 继 
电器 的 相关 材料 出 ， 这 是 可 以 打开 和 关闭 外 部 电路 
的 设备 。 要 使 用 这 些 设 备 ， 首 先 需 要 改造 激光 笔 ， 
让 它 可 以 通过 外 部 开关 切换 。 一 种 方法 是 永久 地 将 
激光 笔 的 按钮 粘 接 到 ON 人 位置， 取出 电池 ， 并 将 两 
个 引线 焊接 到 电池 触 点 上 。 现 在 就 可 以 用 这 些 电 线 
和 激光 笔 的 电池 手动 打开 和 关闭 激光 笔 。 接 下 来 ， 
通过 继电器 或 光 隔 离 器 连接 激光 笔 ， 并 使 用 
Arduino 上 的 数字 引 脚 将 其 打开 ， 用 数字 开关 答 换 
此 方案 。 如 果 使 用 光 隔 离 右 ， 可 以 直接 用 Arduino 
切换 激光 开关 。 如 果 使 用 继电器 ， 还 需要 一 个 驱动 
器 ， 通 第 是 一 个 简单 的 铝 体 管 电路 。 

有 这 样 的 设置 后 ， 请 添加 一 些 代 码 ， 让 Python 
程序 运行 时 ， 发 送 一 个 串 行 命令 到 Arduino， 在 开 
始 之 前 打开 激光 笔 。 











[1] “Relays and Optoisolators,” What-When-How, 
http://what-when-how.com/8051- 
microcontroller/relays-and-optoisolators/ - 


第 14 章 “基于 树 莓 派 的 天 气 监控 加 








当 你 发 现 需 要 更 多 的 计算 能 力 或 外 设 文 持 的 时 
候 ， 如 USB 或 高 清晰 度 多 媒体 接口 CHDMD 视 
频 ， 你 已 经 离开 了 像 Arduino 这 样 的 微 控制 器 领 
W, A SRNL. WREIK (Raspberry Pi) 是 
一 个 小 型 计算 机 ， 可 以 很 好 地 执行 这 样 的 高 级 任 
务 ， 尤 其 是 与 Arduino 相 比 。 


像 Arduino 一 样 ， 树 每 派 在 许多 有 趣 的 项 目 中 
使 用 。 虽 然 可 以 放 在 手掌 中 ， 但 它 是 一 个 完整 的 计 
算 机 《〈 可 以 连接 一 个 显示 项 和 键盘 ) ， 这 让 它 在 教 
师 和 创造 者 中 很 党 欢迎 。 








本 章 将 用 树 侮 派 以 及 多 上 度 和 湿度 传感器 
(DHT11) ， 来 构建 基于 Web 的 温度 和 湿度 监控 系 
统 。 在 树 董 派 上 运行 的 代码 将 启动 Bottle Web 服务 
癸 ， 监 听 传 入 的 连接 。 当 你 访问 本 地 网 络 上 的 树 每 
派 的 Internet 协 议 CIP) 地 址 时 ，Bottle 服 务 器 会 提 
供 包 侣 天气 数据 图 表 的 网 页 。 树 每 上 的 处 理 程序 将 
与 DHT11 传 感 右 通信 ， 取 得 数据 ， 并 返回 给 客户 程 
序 ， 客 户 程序 用 flot 库 在 浏览 器 中 绘制 传感器 数 
据 。 我 们 还 会 为 连接 到 树丛 派 的 发 光 二 极 管 
(LED) 所 供 基 于 Web 的 控制 (这 只 是 为 了 演示 如 
何 用 树 莓 派 通 过 Web 来 控制 外 部 设备 ) 。 


vam 








这 个 项 目 使 用 Python 2.7。 树 侮 派 上 的 Raspbian 操 作 系统 提供 了 
Python 2.7 (在 shell 上 运行 python) 和 Python ”3 在 shell 上 运行 
python3) 。 编 写 的 代码 与 两 者 兼容 。 





14.1 硬件 


像 现在 销售 的 所 有 笔记 本 电脑 或 台式 机 一 样 ， 
树 莓 派 具 有 中 央 处 理 单元 (CPU) 、 随 机 存 取 存 储 
ar (RAM) 、USB 靖 口 、 视 频 输出 、 首 频 输 出 和 网 
络 连 接 。 但 与 大 多 数 计 算 机 不 同 ， 树 每 派 很 便宜 : 
约 35 美 元 。 此 外 ， 由 于 板 载 的 通用 输入 /输出 
(GPIO) 引 脚 ， 树 董 派 可 以 轻松 与 外 部 人 硬件 接 
口 ， 让 它 成 为 各 种 从 入 式 人 硬件 项 目的 理想 选择 。 我 
们 将 用 DHT11 温 度 和 湿度 传 感 费 连接 它 ， 监 控 环 
境 。 


14.11 DHT11 温 湿度 传感器 


DHT11《〈 见 图 14-1) 是 一 种 测量 温度 和 湿度 的 
常用 传感器 。 它 有 4 个 引 脚 : VDD (+) 、 
GND (—) 、DATA， 第 4 个 不 使 用 。DATA 引 脚 连 
接 到 微 控 制 器 〈 在 本 例 中 为 树 每 派 ) ， 输 入 和 输出 
都 通过 该 引 脚 。 我 们 将 用 Adafruit Python 库 
Adafruit Python_DHT 与 DHT11 通 信 ， 取 得 温度 和 
湿度 数据 。 
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图 14-1 DHT11 温 湿度 传感器 


写作 本 书 时 ， 有 3 种 型 号 的 树 每 派 : Raspberry 
Pi 1 Model A +、Raspberry Pi 1 Model B + 和 
Raspberry Pi 2 Model B。 这 个 项 目 使 用 了 较 老 的 
Raspberry Pi Model B Rev 2， 但 项 目 中 使 用 的 引 脚 
号 但 在 所 有 型 号 中 都 兼容 ， 并 且 代 人 码 能 在 所 有 型 所 
ELE, Fem rk. 


14-2 AS f -ANR REBER AEN, CAN 
个 USB 端 口 ， 一 个 HDMI 连 接 器 ， 一 个 复合 视频 输 
出 插 孔 ， 一 个 音频 和 输出 插 孔 ， 一 个 用 于 供电 的 微型 
USB 端 口 ， 一 个 以 太 网 端口 和 26 个 GPIO 引 脚 ， 引 脚 
排 成 两 列 ， 每 列 13 针 。 板 的 底 侧 还 有 SD 卡 插 模 (未 
显示 ) o WAYE Broadcom BCM2835%>H, 1% 
心 片 有 一 个 ARM CPU， 运 行 频率 为 700 MHz， 功 耗 
非常 低 〈 这 就 是 为 什么 树 莓 派 不 像 台式 计算 机 那 
样 ， 需 要 巨大 的 散热 片 来 冷却 它 ) 。B 型 还 有 
512MB 的 SDRAM。 这 些 细 节 大 多 数 对 于 这 个 项 目 
并 不 重要 ， 但 如 果 你 想 用 最 新 袖珍 计算 机 的 所 有 规 
格 给 人 留 下 深刻 印象 ， 这 些 细节 可 能 很 方便 。 

















图 14-2” 树 侮 ; 
树 每 派 型 号 B 


14.13 ”设置 树 每 派 





与 Arduino 不 同 ， 不 外 
rduino 不 同 ， 不 能 将 树 每 派 插 入 计算 机 并 


开始 编码 。 作 为 一 个 完备 的 计算 机 ， 树 奉 派 需要 一 
个 操作 系统 和 一 些 外 设 。 至 少 ， 建 议 使 用 如 图 14-3 
所 示 的 外 设 。 








ue EF. 具有 合适 的 操作 

。 与 树 莓 派 兼 容 的 USB Wi-Fi 适 配器 ; 

。 与 树 莓 派 兼 容 的 电源 〈 宣 方 建议 是 使 用 5V 1200 
mA 电源 ， 如 果 需 要 使 用 所 有 USB 端 口 ， 则 使 用 
5V 2500 mA 电源 ) ; 

。 保 护 宝贵 = REI Es 

. A A hy TEEN, tere AAS 
USB 端 口 的 无 线 组 合 ) ; 

。 复 合 视频 电缆 或 HDMI 电 缆 〈 关 于 树 董 派 使 用 
HDMI 电 级 的 详细 信息 ， 请 参阅 附录 C) 。 








Pi-compatible power 
supply 


Pi-compatible USB 
we Wi-Fi adapter 


ADAPTER 


8GB or higher-capacity SD card 


21. 9 
090000000050 
8OOG00000008 
B00008000008 
ooggag0000 C 
302.432.2239 Composite video cable 
QOSGOCSOODOO 





图 14-3 EAE A EUR Ob UCET 





购买 前 ， 请 务必 检查 已 知 与 Pi 兼容 的 外 围 设 备 列 表 ， 网 址 在 
http://elinuxorg/ RPI_VerifiedPeripherals 。 


14.2 ”安装 和 配置 软件 


现在 可 以 设置 树 每 派 并 准备 编写 Python 了。 下 
一 节 将 简要 介绍 所 需 的 步 台 ， 但 你 应 该 在 安装 前 ， 
看 看 Raspberry Pi Foundation 的 “Getting Started with 
NOOBS” 页 面 上 提供 的 设置 视频 
Chttp://www.raspberrypi.org/help/noobs-setup/) . 


14.2.1 操作 系统 


树 每 派 的 操作 系统 和 文件 将 驻 留 在 外 部 SD 卡 

上 。 虽 然 有 几 个 操作 系统 可 以 选择 ， 但 我 建议 安装 
Raspbian。 操 作 系 统 需 要 以 特定 的 方式 安装 ， 我 不 
会 在 这 里 介绍 细节 《细节 可 能 会 改变 ) ， 而 是 请 你 
去 看 在 Linux wiki 上 的 “RPi Easy SD Card Setup”, P 
Til A http://elinux.org/RPi Easy SD Card Setup. =% 
者 同一 链接 中 的 “Using NOOBS”， 它 更 适合 初学 
Ho 


14.2.2 ”初始 配置 


安装 操作 系统 后 ， 束 可 以 首 次 局 动 了 。 插 入 格 
式 化 的 SD 卡 ， 将 复合 视频 电 统 连接 到 电视 或 显示 
器 ， 连 接 键 盘 和 鼠标 ， 然 后 将 树 每 派 连接 到 电源 。 
树 侮 派 月 动 时 ， 一 个 叫 raspi-config 的 程序 应 该 启 





























动 ， 你 应 该 看 到 各 种 配置 选项 〈 可 以 在 Raspberry Pi 
Foundation 网 站 上 找到 raspi-config 的 文 

档 https://www.raspberrypi.org/documentation/ 
configuration/raspi-config.md) 。 修 改 配置 如 下 : 


1. 选择 Expand Filesystem 以 使 用 完整 的 SD 
卡 ; 

2. 选择 Enable Boot to Desktop/Scratch， 然 后 
选择 Desktop; 

3. 选择 Change Time Zone， 并 在 
Internationalization Options F X E] [X ; 

4. 转 到 Advanced Options 并 启用 Overscan; 


5. 转 到 SSH， 通 过 选择 Enable or Disable SSH 
Server, E Advanced Options HF Ja H ze FE án 
令 行 访问 。 

现在 选择 Finish， 树 蔡 派 应 该 重新 启动 并 显示 
Mo 
14.2.3 ” ”Wi-Fi 设置 

我 们 将 在 此 项 目 中 用 无 线 网 络 连 接 树 每 派 。 假 
设 安装 了 兼容 的 Wi-Fi 适 配器 (请 先 查 阅 
http://elinux.org/ 网 站 ) ，Raspbian 应 该 在 插入 时 目 
VA boas. (ei YER, BME Te 








态 卫 地址 ， 即 利用 内 置 的 Nano 编 辑 器 来 编辑 网 络 配 
置 文件 CNano 有 一 个 极 简单 的 UL 熟悉 它 可 能 需要 
一 点 时 间 。 最 重要 的 事情 是 记得 按 Ctrl-X 并 输入 
Yes， 保 存 文件 并 退出 ) 。 


我 们 将 在 终端 中 运行 命令 。 打 开 
LXTerminal CEN i's Raspbian— FIZ) ， 并 输 
入 以 下 内 容 : 








$ sudo nano /etc/network/interfaces 


区 命令 将 打开 interfaces 文 件 ， 我 们 用 它 来 配置 
网 络 设置 ， 如 下 所 示 ， 


auto lo 


iface lo inet loopback 
iface ethO inet dhcp 


allow-hotplug wlanO 

iface wlanO inet manual 

wpa-roam /etc/wpa supplicant/wpa supplicant.conf 
iface default inet static 

address 192. x.x.x. 

netmask 255.255.255.0 

gateway 192. X.X.X. 





添加 或 修改 文件 末尾 的 address、netmask 和 
gateway 等 行 ， 以 适合 本 地 网 络 。 输 入 网 络 的 网 络 
EA 〈 可 能 为 255.255.255.0) ， 输 入 网 络 的 网 关 


(在 Linuxz 上 从 Linux 终 闫 运行 ifconfig。 在 Windows 
上 按 Windows 和 R 键 ， 然 后 运行 pconfig/all。 或 者 在 
OS X 上 选择 System Preferences->Network) ， 给 树 
每 派 一 个 静态 网 络 IP 地 址 ， 它 不 同 于 网 络 上 任何 其 
他 设备 的 IP 地 址 。 


现在 使 用 WiFi Config 实 用 程序 ， 让 树 每 派 连 接 

Wi-Fi 网 络 。 你 应 该 在 果 面 上 看 到 一 个 快捷 方式 
Cap R3 SUE. iz https://learn.adafruit.com/ 

上 的 Adafruit 教 程 。 如 果 一 切 顺 利 ， 树 每 派 应 该 能 
用 内 置 的 浏览 器 Midori 连 上 因特网 )。 
14.2.4 设置 编程 环境 

接 下 来 ， 我 们 安装 开发 环境 ， 包 括 与 外 部 人 硬件 
通信 所 需 的 RPi.GPIO 包 ，Bottle Web 框架 以 及 在 
Raspberry Pi 上 安装 其 他 Python 包 所 需 的 工具 。 确 保 
己 连接 到 因特网 ， 并 在 终端 中 运行 以 下 命令 ， 每 次 

















$ sudo apt-get update 

$ sudo apt-get install python-setuptools 
$ sudo apt-get install python-dev 

$ sudo apt-get install python-rpi.gpio 

$ sudo easy install bottle 


现在 ， 从 http:/www.flotcharts.org/ 下 载 最 新 版 
本 的 flot JavaScript 绘图 库 ， 将 它 展 开 以 创建 flot 目 


录 ， 并 将 此 目录 复制 到 你 的 程序 所 在 的 文件 夹 中 。 


$ wget http://www.flotcharts.org/downloads/flot-x.zip 
$ unzip flot-x.zip 
$ mv flot myProjectDir/ 





Be RK, FAHFEITUTMS, ZUR 
Adafruit Python DHTF& Chttps://github.com/ 
adafruit/Adafruit Python DHT ， 你 将 用 它 从 连接 
到 树 每 派 的 DHT11 传 感 器 取得 数据 : 


$ git clone https://github.com/adafruit/Adafruit Python DHT.g 
$ cd Adafruit Python DHT 
$ sudo python setup.py install 


树 每 派 现 在 应 该 已 经 设置 好 ， 我 们 己 丝 有 了 构 
建 天 气 监视 程序 所 需 的 全 部 软件 。 


14.2.5 ”通过 SSH 连 接 


与 连接 显示 器 、 用 鼠标 和 键盘 控制 它 相 比 ， 
过 果 面 或 笔 记 本 电脑 登 ee 
Linux 和 OS 又 内 置 了 这 种 支持 ， 即 Secure 
Shell (SSH) 。 如 果 你 用 的 是 windows， 请 安装 
PuTTY UL XE Sz Bl) IN EI o 


以 下 列表 展示 了 典型 的 SSH 会 话 : 





@ moksha:- mahesh$ ssh pi@192.168.4.32 
@ pi@192.168.4.32's password: 
® pi@raspberrypi - $ whoami 


pi 
pi@raspberrypi - $ 


在 这 个 会 话 中 ， 在 @ 行 ， 输 入 ssh 命 令 、 默 认 
HPZ (i) 以 及 IP 地 址 ， 形 如 ssh 
username(@ip_address， 从 我 的 计算 机 登录 到 树 
派 。 输 入 ssh 时 信 ， 会 提示 输入 密码 。 默 认 密码 为 


raspberry。 


你 认为 登录 树 春 派 成 功 后 ， 请 输入 whoami 命 
令 人 @。 如 果 响 应 是 pi， 如 前 所 示 ， 则 已 经 正确 登 








更 改 树 奏 派 的 用 户 名 和 密码 ， 让 和 它 更 安全 ， 这 是 一 个 好 主意 。 
有 关 使 用 树 莅 派 远 程 操作 的 更 多 提示 ， 请 参阅 附录 C。 


14.2.0 ”Web 框架 Bottle 


要 通过 Web 界 面 监视 和 控制 树 每 派 ， 需 要 让 它 
运行 一 个 Web 服 务 右 。 我 们 将 使 用 Bottle， 它 是 一 
个 具有 简单 界面 的 Python Web 框 架 (实际 上 ， 整 个 
库 由 名 为 bottle.py 的 单个 源 文 件 组 成 ) 。 以 下 是 用 
Bottle 提 供 一 个 简单 网 页 所 需 的 代码 : 








from bottle import route, run 
Qroute('/hello') 
def hello(): 

return "Hello Bottle World!" 


run(host='192.168.x.x', port=xxxx, debug-True) 


iX BIB H Python tmar @route X f KR 
由 ， 代 表 一 个 UREL 或 路 径 ， 客 户 端 用 它 来 发 送 数据 
请 求 。 定 义 的 路 由 调用 路 由 函数 ， 返 回 一 个 字符 
串 。run(0) 方 法 启动 Bottle 服 务 器 ， 现 在 可 以 接受 来 
自 客 户 端的 连接 〈 请 务必 提供 你 自己 的 耻 地 址 和 端 
口号 ) 。 请 注意 ， 我 已 将 debug 标 记 设 置 为 True， 
这 样 更 容易 诊断 问题 〉。 

在 连接 到 本 地 网 络 的 任何 计算 机 上 打开 浏览 
器 ， 输 入 http://192.168.4.4: 8080/hello. JEF FIH 4 
派 ，Bottle 应 访 提 供 一 个 网 页 ， 包 含 *Hello Bottle 
World! ”只 需 几 行 代码 ， 就 可 以 创建 一 个 Web 服 
Are 

客户 端 将 利用 异步 JavaScript 和 XML (AJAX) 
REAR, (ARS AS Gest eee EM Bottle) 发 出 
请 求 。 为 了 让 AJAX 调 用 易于 编写 ， 我 们 将 使 用 流 
行 的 jQuery 库 。 











Python 中 的 装饰 占 采 用 @ 语 法 ， 它 将 一 个 函数 作为 参数 ， 并 返 
回 马 一 个 函数 。 装 饰 器 提供 了 一 种 方便 的 方式 ， 用 另 一 个 函数 
来 “包装 ”一 个 函数 。 例 如 ， 这 段 代码 : 


@wrapper 
def myFunc(): 
return 'hi' 


相当 于 执行 以 下 操作 : 


函数 是 Python 中 的 一 等 对 象 ， 可 以 像 变 量 一 样 传递 。 
14.2.7 ”用 flot 绘 制 


现在 让 我 们 来 看 看 如 何 绘 制 数 据 。flot 库 有 一 
个 易于 使 用 的 强大 API， 让 我 们 用 最 少 的 代码 来 创 
建 漂亮 的 图 形 。 基 本 上 ， 我 们 设置 一 些 超 文本 标记 
语言 (HTML) 来 保存 一 个 图 表 ， 并 提供 值 的 一 个 
数组 来 绘图 ，Flot 处 理 其 余 工作 ， 如 这 个 例子 所 示 
《可 以 在 本 书 代 码 库 的 Simple-flot.html 文 件 中 找到 
这 段 代 码 ) 。 





<html> 
<head> 
<meta http-equiv-"Content- 
Type" content="text/html; charset=utf-8"> 
<title>SimpleFlot</title> 
@ <style> 
.demo-placeholder { 
width: 80%; 
height: 80%; 


} 
</style> 
<script language="javascript" type="text/javascript" 
src="flot/jquery.js"></script> 


«script language="javascript" type="text/javascript" 
src="flot/jquery.flot.js"></script> 
<script language="javascript" type="text/javascript"> 
® $(document).ready(function() { 
// create plot 
@ var data = []; 
for(var i = 0; i < 500; i +) { 
data.push([i, Math.exp(- 
i/100)*Math.sin(Math.PI*i/10)]); 
Q var plot = $.plot("#placeholder", [data]); 


«/script» 
</head> 
<body> 
<h3>A Simple Flot Plot</h3> 
<div class="demo-container"> 
@ <div id-"placeholder" class="demo-placeholder"></div> 
</div> 
</body> 
</html> 


在 @ 行 ， 定义 一 个 CSS 类 (demo- 
placeholder) ， 设 置 占 位 符 元 素 的 客 度 和 高 度 ， 来 
保存 绘图 ( 它 将 在 文档 的 主体 中 定义 〉 。 在 信行 ， 

声明 在 此 HTML 文 件 中 将 使 用 的 库 的 JavaScript 文 
m jquery.j$s 和 flot.js《〈 请 注意 ，jQuery 与 flot 捆 绑 在 
一 起 ， 因 此 不 需要 单独 下 载 它 。 此 外 ， 请 确保 将 项 
目录 放 在 包含 此 项 目 所 有 源 代码 的 同一 目录 


接 下 来 ， 用 JavaScript 生 成 要 绘制 的 值 。 在 e 
行 ， 用 jQuery 方法 $(document). ready XE LS ER 
Bl, —HHTML3EJISX ST, UV SUA. TE 























函数 内 部 ， 在 信行 ， 声 明 一 个 空 的 JavaScript 数 
^ 然后 循环 500 次 ， 将 形 如 [i，y] 的 值 添加 到 该 数 
组 加 .每 个 值 表示 这 个 有 趣 函 数 〈 选 择 有 点 随意 ) 
HR A bs e 








rly) = e™ sin (18). xBJ yu. 围 是 [0， 500] 


在 @@ 行 ， 从 flot 库 调用 plot() 来 绘图 。 在 @ 行 ， 
plot() 函 数 将 包含 绘图 的 HTML 元 素 〈(placeholder 元 
A) 的 id 作 为 输入 。 在 浏览 器 中 加 载 生 成 的 HTML 
文件 时 ， 应 该 看 到 如 图 14-4 所 示 的 图 形 。 





À Simple Flot 
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图 14-4 ”用 flot 创 建 的 示例 图 形 


这 里 使 用 了 flot 的 默认 设置 ， 但 你 可 以 通过 调 
整 闫 色 ， 使 用 数据 点 而 不 是 线条 ， 添 加 图 例 和 标 
题 ， 采 用 交互 式 绘 图 ， 以 及 更 多 的 方式 来 定制 flot 
i 会 看 到 设计 天 气 数据 的 图 表 时 
MEERE) o 


14.2.8 KAM AER 


NBER IRTP IS 4T AP EIR AY UR, fH Bé 
会 损坏 文件 系统 ， 让 树 每 派 无 法 局 动 。 要 关闭 树 每 
派 的 用 户 界 面 《 如 条 你 直接 或 从 计算 机 连接 到 该 用 
PRE) ， 请 通过 SSH 输 入 以 下 内 容 : 





$ sudo shutdown -h now 





在 运行 上 一 个 命令 之 前 ， 需 要 确保 已 登录 到 你 的 树 营 派 。 否 
则 ， 你 可 能 会 关闭 主 计算 机 〈 如 果 你 正在 运行 Linux) 。 
im A shutdown S JLE E, MEIRI R E E 
示 灯 应 该 会 内 烁 10 次 。 现 在 你 可 以 安全 地 拔 掉 插 


o 


14.3 15 ETT 





除了 前 面 近 到 的 树 每 派 和 外 设 之 外 ， 还 需要 以 
下 各 项 和 连接 线 : 


。DHT11 传 感 器 ; 
© 4.7kQ FB IB; 

e 1000 8 BH ; 

。 红 人 色 LED; 

« HARK. 


图 14-5 展 示 了 如 何 连 接 所 有 器 件 。DHT11 的 
VDD 引 脚 连 接 到 + 5V OBPAHEK EBJSUBIS2), 
DHT11RJDATA 5| FE Pe SUP AEUK EI AH 16, 
DHT114GND4| HVE BM EVR EAIGND ( 引 脚 
#6) > DATA#HIVDDZ HIER —T4.7KQ HE. 
LED 的 阴极 (负极 ) 通过 100@ 电 阻 器 连接 到 
GND, [HR CER) ERE FIP READ S| AH 18. 


pin 418 (board) 


> LED 
1 
(VDD) (DATA) (unused) (GND) 
100.0 
+5V — pin #6 (GND) 





pin #6 (GND) 


47 kQ pin #16 (board) 
Kl14-5 AVR. DHT11 AES FILED Z [AI MeN xs Ad 


可 以 用 无 焊接 的 面包 板 连 接 DHT11 和 LED 电 路 
并 测试 该 装置 ， 如 网 14-6 所 示 。 当 它 的 工作 令 人 满 
意 后 ， 将 该 装置 移 到 定制 的 外 壳 中 。 











图 14-6” 树 莓 派 、DHT11 和 LCD 与 面包 板 连接 


14.4 ”代码 


ME BATA ARTE EIR EIS AT ARS C 
果 想 查看 完整 的 项 目 代 码 ， 请 跳 到 14.5 节 ) 。 


FillZémainQ PR X: 








def main(): 
print 'starting piweather...' 
# create parser 


parser = argparse.ArgumentParser(description="PiWeather...") 
# add expected arguments 
parser.add argument('--ip', dest-'ipAddr', required-True) 
parser.add argument('-- 

port', dest='portNum', required-True) 


# parse args 
args - parser.parse args() 


4 GPIO setup 
GPIO.setmode(GPIO.BOARD) 

GPIO.setup(18, GPIO.OUT) 

GPIO.output(18, False) 

# start server 

run(host=args.ipAddr, port=args.portNum, debug-True) 


© GOo@ 


在 @@ 行 ， 设 置 了 一 个 命令 行 参数 解析 器 ， 它 有 
两 个 必需 参数 的 : -- 让 表示 服务 器 局 动 的 耳 地 址 ，-- 
port Ka lk wr LI. (EMT. GPIO lv 
置 。 我 们 使 用 BOARD 模 式 ， 表 明 使 用 基于 板 的 物 








理 布局 的 引 脚 编号 惯例 。 在 合 行 ， 将 引 肢 #18 设置 
为 输出 ， 因 为 我 们 打算 同 它 写 入 数据 来 控制 LED， 
在 人 @ 行 ， 设 置 引 脚 值 为 False， 所 以 LED 在 启动 时 关 
有 路 。 然 后 通过 提供 IP 地 址 和 端口 号 启动 Bottle， 并 
将 debug 设 置 为 True， 监 视 所 有 警告 消息 四 。 


14.4.1 bse Ee es AHR ta ok 
WE POSUER — P A SH FE IR AS BE TH OR AY RI AU: 


@ @route('/getdata', method='GET') 

eo HET a 

e = Adafruit DHT.read retry(Adafruit DHT.DHT11, 23) 
: A dictionary 

© return ("RH": RH, "T": T} 


该 方法 定义 了 一 个 名 为 /getdata 的 路 由 @。 客 
户 端 访问 此 路 由 定义 的 URL /getdata 时 ，getdata() 方 
法 被 调用 人 @， 它 利用 Adafruit_DHT 模 块 取得 湿度 和 
温度 数据 全 。 在 @ 行 ， 取 得 的 数据 作为 字典 返回 ， 
它 将 作为 “JavaScript 对 象 表示 法 (JSON) ”对 象 提 
供给 客户 端 。JSON 对 象 包含 由 名 一 值 对 组 成 的 一 
些 列表 ， 可 以 作为 对 象 谈 入 。 在 这 个 例子 中 ， 
getdata() 返 回 的 JSON 对 象 有 个 两 名 一 值 对 : 一 个 是 
湿度 读数 (RH) ， 一 个 是 温度 CD. 


14.4.2 ”绘制 数据 





plotO 函 数 处 理 客户 问 的 绘图 请 求 。 该 函数 的 
第 一 部 分 定义 了 HTML 的 <head> 部 分 ， 设 置 了 “ 层 
ERIK (CSS) ”的 样式 ， 并 加 载 了 必要 的 
JavaScript 代 人 码 ， 如 下 所 示 : 


Qroute('/plot') 
def plot(): 
€ return ''' 
«html» 
«head» 
«meta http-equiv-"Content- 
Type" content="text/html; charset=utf-8"> 
<title>PiWeather</title> 
<style> 
.demo-placeholder { 
width: 90%; 
height: 50%; 
} 
</style> 
«script language-"javascript" type="text/javascript" 
sre="jquery.js"></script> 
«script language="javascript" type="text/javascript" 
sre="jquery.flot.js"></script> 
<script language="javascript" type="text/javascript" 
src="jquery.flot.time.js"></script> 


plot()ei2/plot URE 的 Bottle 路 由 ， 这 表明 连 
接 到 该 URL 时 将 调用 plot0 方 法 。 在 @ 行 ，plot0 将 
整个 HTML 数据 作为 单个 字符 串 返 回 ， 它 将 由 客户 
3m HJ Web pill Wi. ar nano JIRE BJ 4]4511I x HTML br 
题 ， 绘 图 的 CSS 大 小 声明 和 包含 flot 库 的 代码 ， 所 有 
这 些 都 类 似 于 生成 图 14-4 中 的 flot 绘 图 示例 的 设置 。 


代码 的 <body> 元 系 显 示 了 HTML 的 整体 结构 。 











<body> 
«div id="header"> 
<h2>Temperature/Humidity</h2> 
</div> 


<div id="content"> 
<div class="demo-container"> 


<div id="placeholder" class="demo- 
placeholder"></div> 
</div> 
e «div id="ajax-panel"> </div> 
</div> 


<div> 
<input type="checkbox" id="ckLED" value="on">Enable Lighting 
<span id="data-values"> </span> 
</div> 


</body> 
</html> 


EOT, ReARAMI I Tin. (OTT 
WI f <placeholder>7uz, Hie Hi flotHy 
JavaScript V AT. (EMT, X f —MDNajax- 
panel 的 HTML 元 系 ， 它 将 显示 所 有 AJAX 错 误 ， 在 
人 @ 行 ， 创 建 了 一 个 ID 为 ckLED 的 checkbox 元 素 ， 它 
控制 连接 到 树 侮 派 的 LED。 最 后 ， 创 建 了 另 一 个 ID 
为 data-values 的 HTML 元 素 @@， 当 用 户 单 击 绘图 中 
的 数据 点 时 ， 可 以 显示 传 感 右 数据 。JavaScript 代 三 
将 利用 这 些 ID 来 访问 和 修改 相应 的 元 素 。 


现在 让 我 们 来 深入 了 解散 入 的 JavaScript 代 
码 ， 它 们 发 起 传感器 数据 请 求 ， 打 开 和 关闭 LED。 
这 段 代 码 在 <script language “=“javascript”...> 标 记 


中 ， 在 HIML 数 据 <head> 下 面 。 


@ $(document).ready(function() { 
// plot options 
var options = { 
series: { 
lines: {show: true}, 
points: {show: true} 
3 
e grid: {clickable: true}, 
o yaxes: [{min: 0, max: 100}], 
xaxes: [{min: 0, max: 100}], 


// create empty plot 
® var plot = $.plot("#placeholder", [[]], options); 


HTML 数 据 完 全 加 载 后 ， 浏 览 右 调用 什 行 的 
ready Ft. ZEIT, FAHY f —hoptions* RR 
制 绘图 。 在 此 对 象 中 ， 可 以 让 绘图 显示 线 和 点 ， 在 
信行 ， 人 允许 单 击 绘 图 网 格 (用 于 查询 值 )。 在 人 @ 
行 ， 设 置 了 坐标 轴 限 制 。 在 全 行 ， 用 3 个 参数 调用 
plotO 创 建 实 际 绘图 : 要 在 其 中 显示 绘图 的 元 素 的 
ID, EKAA CEFET) ， 以 及 刚刚 设置 的 
options 对 象 。 


接 下 来 ， 看 看 获取 传 感 右 数据 的 JavaScript 代 
18. 








// initialize data arrays 
€ var RH = []; 
var T = []; 


var timeStamp = []; 
// get data from server 
€ function getData() { 
// AJAX callback 
e function onDataReceived(jsonData) { 
@ timeStamp.push(Date()); 
// add RH data 
® RH.push(jsonData.RH); 
// removed oldest 
Q if (RH.length » 100) ( 
RH.splice(0, 1); 


} 

// add T data 

T.push(jsonData.T); 

// removed oldest 

if (T.length » 100) ( 
T.splice(0, 1); 

} 


@ si = []; 
s2 = []; 
for (var i = 0; i < RH.length; i++) { 
si.push([i, RH[i]]); 
s2.push([i, T[i]]); 


} 
// set to plot 
e plot.setData([s1, s2]); 
plot.draw(); 
} 


// AJAX error handler 
© function onError(){ 
$('#ajax-panel').html('< p>Ajax error! < /p>'); 


// make the AJAX call 
(10) $.ajax({ 
url: "getdata", 
type: "GET", 
dataType: "json", 
success: onDataReceived, 
error: onError 


+); 


在 代行 ， 初 始 化 温度 和 湿度 值 的 空 数组 ， 以 及 
一 个 timeStamp 数 组 ， 保 存 收 集 每 个 值 的 时 间 。 在 
信行 定义 了 getData0 方 法 ， 我 们 利用 定时 器 定期 调 
用 该 方法 。 在 全 行 ， 定 义 了 onDataReceived() 方 法 ， 
它 被 设置 为 AJAX 调 用 的 回调 方法 。 在 JavaScript 
中 ， 可 以 在 函数 中 定义 函数 ， 这 些 函 数 可 以 像 单 规 
变量 一 样 使 用 ， 所 以 可 以 在 getData0 函 数 中 定义 
onDataReceived()， 然 后 将 它 作 为 回调 函数 传递 给 
AJAX 调 用 。 











onDataReceived() K LEE y JavaScript Date 对 
Ry MPA ANETTA ER. 来 自 服务 器 的 数据 利 
用 jsonData 对 象 传 入 OnDataReceived()， 在 @ 行 ,， 将 
来 自 此 对 象 的 温度 数据 记 入 数组 。 在 @ 行 ， 如 果 元 
系数 量 超过 100， 束 删除 数组 中 最 早 的 元 素 ， 这 将 
产生 滚动 网 ， 类 似 第 12 章 中 为 Arduino 光 传感器 项 
A 创建 的 滚动 图 。 我 们 用 相同 的 方式 处 理 湿 度数 
Je 


EOT, WRN RHE BT, MEERE 
给 plot(O) 方 法 。 由 于 要 同时 绘制 两 个 变量 ， 所 以 需要 
一 个 包含 3 个 图 层 的 数组 : 

[li o, RH ol, [i 1, RH 1], ...1, [Li o. Tol, li 1, T 11] 

FE QT» BEM IFA Til 

在 信行， 定义 了 一 个 错误 回调 ，AJAX 将 使 用 





之 前 设置 的 、ID 为 ajax-panel 的 HTML 元 素来 显示 错 
误 。 在 雹 行 ， 进 行 实 际 的 AJAX 调 用 ， 它 指定 URL 
为 getdata， 即 Bottle 路 由 。 访 调用 利用 HTTP 的 
GETU0 方 法 ， 以 json 格 式 从 服务 器 请 求 数据 。AJAX 
设置 调用 将 OnDataReceived() 方 法 设置 为 成 功 回 

调 ， 并 将 onErrorO 设 置 为 错误 回调 。 这 个 AJAX 调 
per FEGE FINE, MIB BH 
Ds 


14.4.3 update()7; 7X: 
现在 看 看 每 秒 调 用 getData0 的 update0) 方 法 。 





// define an update function 
function update() { 


// get data 
e getData(); 
// set timeout 
© setTimeout(update, 1000); 


} 


// call update 
update(); 





update() 方 法 首先 在 @ 行 调用 getData()， 然 后 在 
91715 A JavaScriptisetTimeout() FEE 10002& # 
后 调用 它 目 己 。 因 此 ，getData0 每 秒 都 会 被 调用 ， 
从 服务 器 请 求 传感器 数据 。 


14.4.4 用 于 LED 的 JavaScript 处 理 程 序 





现在 来 看 看 LED 复 选 框 的 JavaScript 处 理 程 序 ， 
它 同 Web 服 务 嚣 发送 一 个 AJAX 请 求 。 


// define the click handler for the LED control button 


@ $('#ckLED').click(function() { 
var isChecked = $("#ckLED").is(":checked") ? 1:0; 


e $.ajax({ 

url: '/ledctrl', 

type: 'POST', 

data: ( strID:'ckLED', strState:isChecked j 


}); 
3); 


在 @ 行 ， 为 前 面 在 HTML 中 创建 的 ID 为 ckLED 
的 复 选 框 定义 了 一 个 点 击 处 理 程序 。 每 次 用 户 单 击 
复 选 框 时 ， 将 调用 这 个 单 击 处 理 程序 函数 。 该 函数 
保存 复 选 框 的 状态 信 ， 人 然后 @ 行 的 代码 利用 URL 
/ledctrl 和 HTTP 请 求 类 型 POST 来 调用 AJAX， 它 将 
选中 的 状态 作为 数据 发 送 。 

这 个 AJAX 请 求 的 服务 器 端 处 理 程序 根据 请 求 
将 树 夺 派 的 GPIO 引 脚 设 置 为 打开 或 关闭 。 





@ Qroute('/ledctrl', method='POST') 


def ledctrl(): 
val - request.forms.get('strState') 


e9 
® on = bool(int(val)) 
©  GPIO.output(18, on) 


EOT, 定义 JURL /ledctrl 的 Bottle 路 由 ， 这 


是 处 理 此 请 求 的 ledctrl0 方 法 的 装饰 器 。 在 信行 ， 利 
用 Bottle 的 request 对 象 访问 由 客户 端 代 码 发 送 的 
strState 参 数 的 字符 串 值 ， 该 值 在 @ 行 转换 为 布尔 
值 。 对 引 脚 #18 使 用 GPIO.output(0) 方 法 ， 打 开 或 关 
闭 连 接 到 此 引 脚 的 LED@，。 


14.4.5” 洪 加 交互 性 


我 们 还 希望 为 绘图 提供 一 些 交 互 性 。 ‚lot Kt 
供 了 一 种 方式 让 用 户 点 击 数据 点 获取 值 ， 这 是 在 调 
用 plot0) 函 数 时 ， 通 过 在 options 中 传 入 clickable:true 
I 下 面 ， 我 们 定义 在 单 击 数据 点 时 要 调用 
和 函数 ; 








wo) bind("plotclick", function (event, pos, ite 
if (item) 


plot. nighlight(item. series, item. en) 


© var strData = ' [Clicked Data: ' 
timeStamp[item. dac mE d + Eq tow 
T[item.dataIndex] + ', RH = ' + RH[item.dataIndex] 
十 1 s 
e $('#data-values').html(strData); 
} 
3); 
3); 
«/script» 
«/head» 


该 函数 在 @ 行 调用 flot 的 highlight() 方 法 ， 在 单 
击 的 点 周围 绘制 一 个 圆 环 。 在 信行 ， 它 准备 一 个 字 


符 串 ， 以 显示 在 ID 为 data-value 的 HIMEL 元 素 中 。 点 
击 数据 点 时 ，flot 会 回国 数 传 入 一 个 item 对 象 ， 它 有 
一 个 名 为 dataIndex 的 成 员 。 我 们 可 以 利用 此 索引 ， 

从 ready(0) 函 数 中 定义 的 时 间 惟 、 温 度 和 湿度 数组 中 
E 最 后 ， 将 字符 串 添 加 到 HTML 元 素 


这 了 吏 是 Python 代码 中 磐 入 的 JavaScript， 但 我 们 
还 需要 一 个 Bottle 路 由 来 找到 Web 页 面 需要 的 
JavaScript 文 件 ， 如 下 所 示 : 


@route( '/<filename:re:.*\.js>') 
def javascripts(filename): 
return static_file(filename, root-'flot') 


iX BUB VrBottleik SF Arte F A 3float/ FE 
找 这 些 文件 ， 它 在 与 程序 同 级 的 目录 下 。 





14.5 ”完整 代码 


可 以 在 
https://github.com/electronut/pp/tree/master/piweather/| 
找到 此 项 目的 完整 代码 列表 。 


from bottle import route, run, request, response 
from bottle import static file 

import random, argparse 

import RPi.GPIO as GPIO 

from time import sleep 

import Adafruit DHT 


Qroute('/hello') 
def hello(): 
return "Hello Bottle World!" 


@route( '/<filename:re:.*\.js>') 
def javascripts(filename): 
return static_file(filename, root-'flot') 


@route( '/plot') 
def plot(): 
return ''' 
<html> 
<head> 
<meta http-equiv-"Content- 
Type" content="text/html; charset=utf-8"> 
<title>PiWeather</title> 
<style> 
.demo-placeholder { 
width: 90%; 
height: 50%; 


} 

</style> 

«script language-"javascript" type="text/javascript" 
sre="jquery.js"></script> 

«script language="javascript" type="text/javascript" 


src="jquery.flot.js"></script> 

<script language="javascript" type="text/javascript" 
src="jquery.flot.time.js"></script> 

«script language="javascript" type="text/javascript"> 


$(document).ready(function() { 


// plot options 
var options = { 
series: { 
lines: {show: true}, 
points: {show: true} 


ty 
grid: {clickable: true}, 
yaxes: [{min: 0, max: 100}], 
xaxes: [{min: 0, max: 100}], 


}; 


// create empty plot 
var plot = $.plot("#placeholder", [[]], options); 


// initialize data arrays 
var RH = []; 
var T= []; 
var timeStamp - []; 
// get data from server 
function getData() { 
// AJAX callback 
function onDataReceived(jsonData) { 
timeStamp.push(Date()); 
// add RH data 
RH.push(jsonData.RH); 
// removed oldest 
if (RH.length > 100) { 
RH.splice(0, 1); 


} 

// add T data 

T.push(jsonData.T); 

// removed oldest 

if (T.length » 100) ( 
T.splice(0, 1); 

} 


si = []; 

s2 = []; 

for (var i = 0; i < RH.length; i++) { 
si.push([i, RH[i]]); 
s2.push([i, T[i]]); 


// set to plot 
plot.setData([s1, s2]); 
plot.draw(); 

} 


// AJAX error handler 

function onError(){ 

$('#ajax-panel').html('<p><strong>Ajax error! 
</strong> </p>'); 


// make the AJAX call 

$.ajax({ 
url: "getdata", 
type: "GET", 
dataType: "json", 
success: onDataReceived, 
error: onError 

3); 

} 


// define an update function 
function update() { 

// get data 

getData(); 

// set timeout 

setTimeout(update, 1000); 
} 


// call update 
update(); 


// define click handler for LED control button 
$('#ckLED').click(function() { 
var isChecked = $("#ckLED").is(":checked") ? 1:0; 
$.ajax({ 
url: '/ledctrl', 
type: 'POST', 
data: ( strID:'ckLED', strState:isChecked j 
3); 
3): 


$("#placeholder").bind("plotclick", function (event, pos, ite 
if (item) { 
plot.highlight(item.series, item.datapoint); 
var strData = ' [Clicked Data: ' + 
timeStamp[item.dataIndex] + ': T= ' + 


T[item.dataIndex] + ', RH = ' + RH[item.dataIndex] 
de Va E 
$('#data-values').html(strData); 


3); 
3); 


«/script» 
</head> 


<body> 
«div id="header"> 
<h2>Temperature/Humidity</h2> 
</div> 


<div id="content"> 
<div class="demo-container"> 


<div id="placeholder" class="demo-placeholder"> 
</div> 
</div> 
«div id="ajax-panel"> </div> 
</div> 
<div> 


<input type="checkbox" id="ckLED" value="on">Enable Lighting. 
<span id="data-values"> </span> 
</div> 


</body> 
</html> 


Qroute('/getdata', method='GET' ) 

def getdata(): 
RH, T = Adafruit_DHT.read_retry(Adafruit_DHT.DHT11, 23) 
# return dictionary 
return {"RH": RH, "T": T} 


Qroute('/ledctrl', method='POST' ) 
def ledctrl(): 
val - request.forms.get('strState') 
on - bool(int(val)) 
GPIO.output(18, on) 


# main() function 
def main(): 
print 'starting piweather...' 


# create parser 


parser = argparse.ArgumentParser(description="PiWeather...") 
# add expected arguments 
parser.add argument('--ip', dest-'ipAddr', required-True) 
parser.add argument('-- 

port', dest='portNum', required-True) 


# parse args 
args - parser.parse args() 


# GPIO setup 

GPIO.setmode(GPIO.BOARD) 

GPIO.setup(18, GPIO.OUT) 

GPIO.output(18, False) 

# start server 

run(host=args.ipAddr, port=args.portNum, debug-True) 


# call main 
if _name__ == ' main ': 
main() 


14.6 ”运行 程序 
将 树 莓 派 连接 到 DHT11 和 LCD 电 路 后 ， 利 用 


SSH 从 计算 机 登录 树 和 侮 派 ， 并 输入 以 下 内 容 〈 和 蔡 换 
你 为 树 侮 派 设置 的 IP 地 址 和 端口 ) : 


$ sudo python piweather.py --ip 192.168.x.x --port xxx 


现在 打开 浏览 器 ， 在 浏览 器 的 地 址 栏 中 输入 树 
莓 派 的 卫 地 址 和 端口 ， 形 式 为 : 


http://192.168.x.x:port/plot 


你 应 该 看 到 如 图 14-7 所 示 的 图 形 。 


Temperature/Humidity 








10 x 


) x 50 
M Enable Lighting, [Clicked Data: Tue Jun 24 2014 15:55:30 GMT40530 (IST): T = 28, RH = 45] 


4) 


图 14-7 piweather.pyzn Wiz £T HY 4G SRY vi fH ES 


A AR ATH AR n BEER no mu RID D 
分 应 该 更 新 ， 显 示 有 关 该 点 的 更 多 信息 。 在 收集 到 
100 个 点 后 ， 当 新 数据 进入 时 ， 图 形 将 开始 水 平 深 
动 〈 单 击 Enable Lighting 复 选 框 来 打开 和 关闭 
LED) 。 
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AS HUA ASE PEP EIR Dos 
XE Web Fr H 22: d ERU FE BG © RTH ANI 
ifs B ERES: 


© KE BE 

。 使 用 树 每 派 的 GPIO 引 脚 与 便 件 通信 

。 与 DHT11 温 湿度 传感器 接口 

。 使 用 Python Web 框 架 Bottle 来 创建 Web 服 务 右 ; 
。 使 用 JavaScript 库 flot 来 制作 图 表 ; 

。 构 建 客户 问 一 服务 器 应 用 程序 ; 

。 通 过 Web 界 面 控制 硬件 。 


14.8 ”实验 


请 尝试 通过 以 下 修改 来 改进 此 项 目 。 


1. 提供 一 种 导出 传 感 占 数据 的 方法 。 一 种 简 
单 的 方法 是 在 服务 右上 维护 一 个 〈《T，RH) 元 组 的 
列表 ， 然 后 为 /export 写 一 个 Bottle 路 由 ， 并 在 这 个 方 
法 中 返回 CSV 格 式 的 值 。 修 改 /plot 路 由 ， 使 其 包 合 
HTML 代 人 码 ， 在 网 页 上 放置 Export” 按 钮 。 单 击 该 
按钮 时 ， 有 相应 的 AJAX 代 码 调用 服务 器 上 的 
export() 方 法 ， 它 将 发 送 要 在 浏览 右 中 显示 的 CSV 
然后 ， 这 些 值 可 以 让 用 户 从 浏览 器 窗口 中 复制 
或 保存 。 


2. 该 程序 绘制 DHT11 数 据 ， 但 100 个 值 后 ， 它 
开始 滚动 。 如 果 想 碍 看 更 长 时 间 的 历史 数据 怎么 
JM? 一 种 方法 是 在 服务 器 上 维护 一 个 较 长 的 〈T， 
RH) 元 组 列表 ， 然 后 修改 服务 器 代码 ， 利 用 一 个 
按钮 来 发 送 HIML 数 据 ， 并 使 用 必要 的 JavaScript 代 
人 码 ， 在 绘制 完整 范围 的 数据 或 仅 绘 制 最 近 100 个 值 
之 则 切换 。 如 何 取 得 树 每 派 关 闭 之 前 的 老 数 据 〈 提 
zw: 当 服 务 右 退出 时 ， 将 数据 写 入 文本 文件 ， 并 在 
ABN IMME RE) ? 要 使 此 项 目 真 正 可 扩展 ， 请 
使 用 数据 库 ， 如 SQLite。 














附录 A ”软件 安装 





在 本 附录 中 ， 我 将 介绍 如 何 安装 Python， 以 及 
本 书 中 使 用 的 外 部 模块 和 代码 。 由 于 第 14 章 中 已 经 
介绍 了 几 个 树 每 派 相关 项 目的 安装 ， 这 里 将 跳 过 这 
些 说 明 。 本 书 中 的 项 目 己 经 用 Python 2.7.8 和 Python 
3.3.3247 AR. 


Al 安 竣 本 市 项 目的 尝 代 人 鬼 


你 可 以 从 https://github.com/electronut/pp/ 下 载 这 
本 书 的 项 目的 源 代码 。 使 用 此 网 站 上 的 Download 
ZIP 选 项 来 获取 代码 。 


下 载 并 解压 缩 代码 后 ， 需 要 将 下 载 的 代码 中 的 
common XFX AER 4 GY App-master/common ) 
添加 到 PYTHONPATH 环 境 变量 中 ， 以 便 模块 可 以 
谷 找 和 使 用 这 些 Python 文 件 。 


在 Windows 上 ， 实 现 的 方式 是 创建 
PYTHONPATH 环 境 变 量 ， 如 果 它 已 经 存在 ， 则 添 
加 它 。 在 OS X 上 ， 可 以 将 此 行 添加 到 主 目录 中 
的 .profile 文 件 〈 如 果 和 需要 就 创建 一 个 文件 ): 





export PYTHONPATH=$PYTHONPATH:path_to_common_folder 


Linux 用 户 可 以 执行 类 似 于 OS X 的 操作 ， 
在 .bashrc、.bash_profile 或 .cshrc/.jogin 中 添加 。 可 以 
使 用 echo $SHELL 命 令 碍 看 默认 shell。 


现在 ， 来 看 看 如 何在 Windows、OS X#lLinux 
上 安 闭 Python 以 及 本 书 中 使 用 的 模块 。 








A.2 在 Windows 上 安装 


B5 Ahttps//www.python.org/download/ F &X 
JF 223€ Python. 


A2.1 安装 GLFW 


对 于 本 书 中 基于 OpenGL 的 3D 图 形 项 目 ， 需 要 
GLEFEW 库 ， 你 可 以 从 http:/www.glfw- 
org/download.html 下 载 。 


在 Windows 上， 安装 GLFW 后 ， 将 
GLFW_LIBRARY 环 境 变 量 〈 在 搜索 栏 中 键入 Edit 
Environment Variables) 设置 为 安 痛 glfw3.d11 的 完整 
路 径 ， 以 便 GLFW 的 Python 绑 定 能 找到 此 库 。 路 径 
看 起 来 类 似 CAY glfw-3.0.4.bin. WIN32\lib- 
msvc120\glfw3.dll. 


在 Python 中 使 用 GLFW， 要 用 一 个 名 为 pyglfw 
你 不 圭 要 安装 pyglftw， 因 为 本 书 的 源 代码 已 包含 
它 ， 可 以 在 common 目 录 中 找到 它 。 但 是 ， 如 果 和 十 
要 安装 较 新 的 版 本 ， 来 源 是 https://github.com/ 
rougier/pyglfw/. 





你 还 需要 确保 计算 机 已 安装 显卡 驱动 程序 。 这 
通常 是 有 好 处 的 ， 因 为 许多 软件 程序 (特别 是 洲 
戏 ) 都 会 利用 图 形 处 理 单元 (GPU) 。 

A.2.2 ”为 每 个 模块 安 竣 预 完 构 建 二 进 制 文 
人 





在 Windows 上 安 儿 必要 的 Python 模块 ， 最 简单 
的 方法 是 获取 预先 构建 的 二 进 制 文 件 。 每 个 模块 的 
链接 在 下 面 列 出 。 请 下 载 适 当 的 安装 程序 (32 或 64 
AL) 。 根 据 Windows 设 置 ， 你 可 能 需要 以 管理 员 权 
限 来 运行 这 些 安装 程序 。 


pyaudio 
http://www.lfd.uci.edu/-gohlke/pythonlibs/Zpyauc 


pyserial 
http://www.lfd.uci.edu/-gohlke/pythonlibs/Zpyser 
scipy 


http://www.lfd.uci.edu/-gohlke/pythonlibs/Zscipy 
http://sourceforge.net/projects/scipy/files/scipy/ 


numpy 


http://www.lfd.uci.edu/~gohlke/pythonlibs/#nump 


http://sourceforge.net/projects/numpy/files/NumPy 


pygame 
http://www.lfd.uci.edu/-gohlke/pythonlibs/Zpygar 
Pillow 


http://www.lfd.uci.edu/-gohlke/pythonlibs/Zpillov 
https://pypi.python.org/pypi/Pillow/2.5.0#downlo: 
pyopengl 
http://www.lfd.uci.edu/-gohlke/pythonlibs/Zpyope 
matplotlib 
http://www.lfd.uci.edu/-gohlke/pythonlibs/Zmatpl 


matplotlib 库 依赖 于 dateutil、pytz、pyparsing 和 
six， 这 些 依赖 库 可 以 从 以 下 链接 获得 : 


dateutil 


http://www.lfd.uci.edu/-gohlke/pythonlibs/Zpytho 
dateutil 


pytz 
http://www.lfd.uci.edu/~gohlke/pythonlibs/#pytz 


pyparsing 
http://www.lfd.uci.edu/-gohlke/pythonlibs/Zpypar 
six 
http://www.lfd.uci.edu/-gohlke/pythonlibs/Zsix 
A.2.3 其 他 选项 


你 也 可 以 安装 适当 的 编译 占 ， 在 Windows 上 目 
己 构 建 所 有 必需 的 软件 包 。 有 关 莱 容 编 译 器 的 列 
表 ， 参 见 
https://docs.python.org/2/install/index.html#gnu-c- 
cygwin-mingwe “Sie FE 
7Ehttp://www.scipy.org/install htm] Z FIR HY Python 
BATH, FP TUR Y KW ET 





AB 在 OS 久 上 安装 


以 下 是 在 OS X 上 安装 Python 和 必要 模块 的 建议 


HERR 
A.3.1 安装 Xcode 和 MacPorts 


第 一 步 是 安装 Xcode。 你 可 以 通过 App Store 获 
取 它 。 如 果 你 运行 的 是 旧版 本 的 操作 系统 ， 则 可 以 
从 Apple 开 发 人 员 网 站 (https: // 
developer.apple.com/) 获取 兼 容 版 本 的 Xcode。 安 装 
Xcode 后 ， 请 确保 也 安装 了 命令 行 工 具 。 下 一 步 是 
安装 MacPorts。 你 可 以 参考 MacPorts 指 南 
Chttp://guide.macports.org/#installing.xcode) ， 其 中 
包含 了 详细 的 安装 说 明 ， 以 帮助 你 完成 此 过 程 。 


MacPorts 安 装 自己 的 Python 版 本 ， 最 简单 的 方 
法 是 你 的 项 目 残 使 用 该 版 本 COS XbA ES 
Python， 但 在 它 上 面 安 装 模 块 有 许多 问题 ， 所 以 最 
好 不 要 管 它 ) 。 


A.3.2 ”安装 模块 


安装 MacPorts 后 ， 可 以 使 用 Terminal (24 Yr ) 
应 用 程序 中 的 port 命 令 ， 安 装 本 书 所 雷 的 模块 。 























x 在 终端 窗口 中 使 用 下 面 的 命令 检查 Python 的 版 


$ port select --list python 


如 果 你 有 多 个 Python 安装 ， 可 以 使 用 下 面 的 命 
4, pecus 的 Python 作为 MacPorts 的 活动 版 
本 ( 选择 了 Python 版 本 2.7) : 





$ port select --set python python27 





ZRA E ARR ERR. EA Im i H PEA 


运行 这 些 命令 。 


sudo port install py27-numpy 

sudo port install py27-Pillow 
sudo port install py27-matplotlib 
sudo port install py27-opengl 
sudo port install glfw 

sudo port install py27-scipy 

sudo port install py27-pyaudio 
sudo port install py27-serial 
sudo port install py27-game 


ke) 


MacPorts 通 常 将 Python 安装 在 /opUlocal/ 中 。 可 
S 竺 .profile 中 设置 PATH 环境 变量 ， 来 确保 在 
终端 窗口 中 获得 正确 的 Python 版 本 。 这 是 我 的 设 

B. 











PATH-/opt/local/Library/Frameworks/Python.framework/Versions/ 
export PATH 


这 段 代码 确保 正确 的 Python 版 本 可 以 从 任何 终 
端 运行 。 


AA 在 Linux 上 安装 


Linux 通 名 内 置 Python 并 且 构 建 所 需 软件 包 的 
所 有 开发 工具 。 在 大 多 数 Linux 发 行 版 上 ， 应 该 能 
够 使 用 pip 获 取 本 书 所 需 的 包 。 有 关 安 六 pip 的 说 
明 ， 请 参阅 以 下 链接 : 
http://pip.readthedocs.org/en/latest/installing.html . 


可 以 用 pip 安 装 一 个 包 ， 像 这 样 : 








sudo pip install matplotlib 





另 一 种 安装 软件 包 的 方法 是 下 载 模块 源 代码 ， 
通常 是 .gz 或 .zip 文 件 。 将 这 些 文 件 解压 顷 到 文件 夹 
后 ， 可 以 按 如 下 方法 安装 它们 : 





sudo python setup.py install 


对 于 本 书 所 需 的 每 个 包 ， 你 需要 使 用 这 些 方法 
中 的 一 种 。 


附录 B ”基础 实用 电子 学 





本 附录 简要 介绍 了 搭建 电子 电路 相关 的 一 些 基 
本 术语 、 组 件 和 工具 。 电 子 学 是 工程 学 分 文 ， 涉 及 
利用 有 源 和 无 源 电 子 元 件 ， 设 计 和 构造 电路 。 


这 个 主题 很 大 ， 所 以 我 仅仅 论 及 皮毛 出 。 但 从 
爱好 者 或 DIY CHEAT) 的 角度 来 看 ， 你 不 需要 
知道 一 大 扒 知 识 ， 就 能 开始 玩 电子 电路 。 你 可 以 在 
搭建 中 学 习 ， 根 据 我 自己 的 经 验 ， 这 是 一 个 有 趣 
的 、 令 人 上 注 的 爱好 。 我 希望 通过 快速 介绍 以 下 主 
题 ， 激 励 你 开始 阅读 这 方面 的 内 容 ， 并 让 你 开始 设 
计 和 搭建 自己 的 电路 。 








B.1 第 用 组 件 





大 多 数 电 子 部 件 使 用 半导体 类 的 材料 。 半 导体 
oo a 
A ae T 


在 本 市 中 ， 我 们 将 介绍 电路 中 使 用 的 一 些 最 常 
见 的 组 件 。 图 B-1 展 示 了 这 些 组 件 ， 以 及 在 电路 图 
中 表示 它们 的 符号 。 
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B.1. 面包 板 
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常用 电子 组 件 及 其 相应 的 符号 
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面包 板 是 用 于 原型 电子 电路 的 多 孔 模 块 。 面 包 
MMF A eR, JFE ARAINA. 
连 ， 容 易 进行 实验 。 不 必 焊 接 每 个 连接 ， 只 要 将 组 
件 插入 面包 板 ， 并 用 电线 连接 它们 。 


B.1.2 ”光敏 电阻 CLDR) 


LDR 是 一 种 电阻 堪 ， 其 电阻 随 着 照 在 其 上 的 光 
的 强度 而 减 小 。 它 用 作 电 子 电路 中 的 光 传 感 右 。 


B.1.3 ”集成 电路 (IC) 


IC 是 包含 完整 电子 电路 的 器 件 。IC 非 常 小 ， 每 
平方 厘米 可 以 包含 数 十 亿 唱 体 管 。 每 个 IC 通常 都 有 
一 种 特定 的 应 用 ， 制 造 商 的 数据 表 提 供 了 必要 的 原 
理 图 、 电 气 和 物理 特性 ， 以 及 示例 应 用 程序 ， 以 帮 
助 用 户 。 你 可 能 会 遇 到 的 和 常见 IC 是 555， 它 的 主要 
用 作 定 时 器 。 

B.1.4 印刷 电路 板 (PCB) 

要 制作 电子 电路 ， 需 要 一 个 地 方 来 组 装 组 件 。 
通常 在 PCB 上 完成 此 操作 ， 该 PCB 由 绝缘 体 组 成 ， 
绝缘 体 上 有 一 层 或 多 层 导 电 材料 (通常 为 铜 ) 。 导 
电 层 成 形 的 方式 让 它 形 成 电路 的 布线 。 

元 件 作为 “ 通 孔 ”元 件 或 “表面 安装 ”元 件 安 装 到 
PCB 上 ， 通 过 焊接 与 导电 层 实 现 导 电 连 接 。 
































B.1.5 ”电线 


挫 电 路 不 能 没有 电线 。 我 们 将 使 用 塑料 绝缘 的 
铜 线 。 


B.1.6 电阻 


电阻 是 电路 中 最 第 见 的 元 件 之 一 。 电 阻 用 于 减 
小 电路 中 的 电流 或 电压 ， 并 且 根 据 其 阻 值 《以 欧姆 
为 单位 ) 来 指定 。 例 如 ，2.7k 欧 姆 电阻 具有 2.7 王 欧 
GEE 2700 EHEN BELLE © BIRA TR as IHN E 
Be LET een CMM 


B17 发 光 二 极 管 (LED) 


LED 是 在 许多 电路 中 看 到 的 小 闪烁 的 条 。 然 
而 ，LED 是 特殊 类 型 的 二 极 管 ， 因 此 它 也 具有 极 
性 ， 并 需要 根据 极 性 连接 。 它 通常 与 电阻 器 结合 使 
用 ， 限 制 流 过 它 的 电流 ， 因 此 不 会 损坏 。 不 同 闫 色 
的 LED 上 共有 不 同 的 最 小 * 导 通 ”电压 。 


B18 ”电容 器 

电容 是 有 两 个 引线 的 器 件 ， 用 于 存储 电荷 。 它 
是 根据 电容 量 来 测量 的 ， 其 单位 为 法 拉 。 典 型 电容 
的 电容 量 以 微 法 〈hEF) 为 单位 。 电 容 有 极 化 和 非 极 
化 两 种 。 



























































B19 ”二极管 


二 极 过 是 允许 电流 仅 在 一 个 方 同 上 通过 的 电子 
Fo EEE ATE ita CHACHA 
DCAF) . “MEA PAAR SIZE: 阳极 和 阴极 。 
Ra CARIE, PT PAR S] R BS Sy FEL 
余部 分 正确 连接 。 


B.1.10 “晶体管 


晶体 管 可 以 看 成 是 电子 开关 。 蝇 体 管 还 可 以 用 
作 电 流 或 电压 的 放大 器 。 作 为 集成 电路 的 基本 构 
件 ， 写 是 最 重要 的 电子 部 件 之 一 。 品 体 管 有 几 种 类 
型 ， 但 最 常见 的 是 双 极 型 晶体 管 〈BJT) 和 金属 氧 
化 物 半 导体 场 效 应 晶体 管 (MOSFET) . dh EH 
常 有 三 根 引 线 。 对 于 BJT， 它 们 被 命名 为 基 极 、 集 
电极 和 发 射 极 ， 而 对 于 MOSFET， 它 们 被 命名 为 栅 
极 、 源 极 和 漏 极 。 当 唱 体 管用 作 开 关 时 ，BJT 的 基 
极 电 流 《〈 或 MOSFET 的 栅 极 电压 ) ， 是 让 电流 能 人 够 
流 过 集 电极 和 发 射 极 的 原因 ， 因 此 它 作 为 开关 ， 控 
制 外 部 负载 ， 如 LED 或 继电器 。 


B.1.11 电池 /电源 
大 多 数 电 子 设备 在 3 到 9 伏 的 小 电压 下 工作 ， 这 


种 电压 可 以 由 电池 提供 ， 或 利用 插入 场 上 交流 电源 
插座 的 电源 适 配 占 提供 。 
































B.2 基本 工具 


除了 刚才 描述 的 组 件 ， 你 还 需要 一 些 基 本 工 
具 ， 才 能 开始 搭建 电子 电路 。 图 B-2 展 示 了 业余 爱 
好 者 的 工作 台 上 通常 会 看 到 的 工具 。 接 下 来 介绍 其 
中 一 些 基 本 工具 。 
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万 用 表 是 用 于 测量 电路 的 电气 特性 (例如 电 
压 、 电 流 、 电 容 和 电阻 〉 的 仪器 。 它 还 经 常用 于 测 
量 电 路 中 的 连续 性 ， 这 表示 电流 的 连续 流动 。 当 你 
试图 调试 电路 时 ， 万 用 表 是 非常 有 用 的 。 


B.2.2 ”烙铁 及 配件 


对 电路 在 面包 板 上 工作 感到 满意 后 ， 下 一 步 台 
是 将 它 转 移 到 PCB 上 ， 这 需要 焊接 。 焊 接 是 使 用 加 
热 的 填充 金属 来 接合 两 种 金属 的 过 程 。 填 料 或 焊 
料 ， 过 去 人 台 铅 ， 但 现在 第 用 无 铅 租 料 合金 ， 这 更 环 
保 。 要 焊接 元 件 时 ， 将 元 件 放 在 PCB 上， 加 上 助 焊 
剂 《使 焊接 过 程 更 容易 的 化 学 品 ) ， 然 后 将 热 的 焊 
料 与 烙铁 一 起 使 用 。 焊 料 冷却 时 ， 它 在 部 件 和 铜 箱 
层 之 间 形 成 物理 结合 和 电 连 接 。 


B.2.3 ”示波器 


示波器 是 用 于 测量 和 显示 来 自 电 子 电路 的 电压 
的 仪器 。 它 是 分 析 电 压 波 形 的 有 用 工具 。 例 如 ， 可 
以 用 它 来 调试 从 传感器 输出 的 数字 数据 ， 或 测量 从 
音频 放大 器 输出 的 模拟 电压 。 它 还 有 其 他 专门 的 测 
量 功能 ， 如 快速 傅 里 叶 变 换 CFFTO 和 均 方 根 
































(RMS) 。 


图 B-2 还 展示 了 搭建 电路 的 一 些 其 他 有 用 的 工 
A: 多 头 螺丝 刀 、 人 尖 嘴 钳 、 剥 线 钳 、 用 于 在 焊接 时 
问 定 PCB 的 夹具 、 让 工作 区 域 照明 民 好 的 台灯 、 和 天 
助 你 查看 小 元 件 和 焊接 点 的 放大 镜 ， 以 及 用 于 烙铁 
SK TA Ye a © 





B.3 搭建 电路 





在 搭建 电路 时 ， 从 电路 图 或 原理 图 开始 ， 它 将 
告诉 你 组 件 如 何 相互 连接 。 通 常 ， 你 会 在 面包 板 上 
搭建 该 电路 ， 插 入 元 件 并 用 导线 连接 它们 。 测 试 电 
路 并 满意 后 ， 你 可 能 会 考虑 把 它 移 到 PCB 上 。 虽然 
面包 板 很 方便 ， 但 它 看 起 来 有 点 乱糟糟 ， 这 些 松 散 
的 电线 在 部 署 时 会 不 可 靠 。 


你 可 以 使 用 通用 PCB， 它 的 底部 有 固定 的 铜 图 
案 ， 也 可 以 设计 自己 的 PCB。 前 者 很 适合 小 电路 。 
通常 ， 你 会 焊接 元 件 ， 利 用 已 经 存在 的 铜 销 连接 ， 
然后 根据 需要 通过 焊接 额外 的 电线 来 搞定 其 余部 
分 。 图 B-3 展 示 了 一 个 简单 电路 的 原理 图 、 面 包 板 
原型 和 PCB 结 构 。 


如 果 你 想 要 非常 漂亮 的 PCB， 可 以 自己 设计 一 
个 并 制造 出 来 ， 也 花费 不 多 。 有 几 个 软件 包 可 用 于 
设计 PCB， 但 最 常用 的 (免费 ) AEAGLE?! Fn 
KiCadH。EAGLE 软 件 有 一 个 简 版 是 免费 的 ， 条 件 
是 只 用 于 非 营 利 应 用 。 它 有 一 定 的 限制 (例如 ， 只 
有 两 个 铀 层 ， 最 大 PCB 尺 寸 为 10 厘 米 x8 厘 米 ， 每 个 
项 目 一 张 原理 图 ) ， 但 这 些 对 于 爱好 者 来 说 应 该 不 
会 有 太 大 的 问题 。 但 是 ，EAGLE 的 学 习 曲 线 有 些 陡 



































I, MARSA AS APRS. EFRA, 
我 建议 你 先 看 一 些 视频 教程 外。 























图 B-3 ”从 原理 图 到 面包 板 原 型 ， 再 到 PCB 电 路 


EAGLE 中 的 典型 工作 流程 如 下 : 首先 ， 在 原 
理 图 编辑 器 中 创建 电路 图 。 为 此 ， 需 要 添加 电路 中 
使 用 的 元 件 ， 然 后 连 线 。EAGLE 有 大 量 的 元 件 库 ， 
很 可 能 你 的 组 件 已 经 在 那些 库 中 列 出 〈EAGLE 还 人 允 
许 你 创建 自己 定义 的 组 件 ) 。 完 成 原理 图 后 ， 
EAGLE 就 可 以 从 中 生成 一 个 PCB， 从 而 生成 这 些 元 
件 的 物理 表示 。 然 后， 需要 放置 元 件 并 完成 电路 布 
线 ， 设 计 PCB 上 铀 稍 层 的 连接 路 径 。 典 型 的 EAGLE 
设计 如 图 B-4 所 示 。 左 边 是 原理 图 ， 右 边 是 相应 的 
电路 板 。 使 用 EAGLE 需 要 一 些 练 习 ， 但 YouTube 教 
程 将 帮助 你 起 步 。 















































图 B-4 使 用 EAGLE 创 建 的 电路 原理 图 和 相应 的 PCB 设 计 


设计 了 PCB 后 ， 你 需要 制造 它 。 一 些 制 造 PCB 
的 技术 可 以 在 家 里 完成 由， 这 可 以 很 有 趣 ， 但 更 专 
业 的 技术 是 将 你 的 设计 发 送 给 PCB 制 造 商 。 这 些 公 
司 通 常 接 受 Gerber 设 计 格 式 ， 你 可 以 直接 从 EAGLE 
生成 这 些 文件 ， 只 需 一 点 设置 创 。 许 多 公司 制造 
PCB。 我 接触 过 一 个 很 好 的 公司 是 OSH Park. 

完成 了 PCB 和 元 件 焊 接 后 ， 要 考虑 你 的 项 目的 


外 壳 。 当 前 的 制造 技术 允许 你 用 激光 打印 和 3D 打 印 
等 技术 ， 设 计 并 构建 专业 外 观 封装 。 你 可 以 使 用 








2D 邮 和 3D 负 软件 的 组 合 来 设计 你 的 作品 。Rich 
Decibels 的 一 个 项 目 很 好 地 说 明了 这 里 讨论 的 整个 
ME, 


B.4 下 一 步 








你 可 以 从 两 个 角度 来 探索 实用 电子 学。 第 一 个 
是 从 头 开 始 ， 学 习 将 简单 的 电路 放 在 一 起 ， 了 解 模 
拟 和 数字 电路 ， 最 后 继续 了 解 微 控制 占 和 与 计算 机 
的 接口 电路 。 男 一 种 方法 是 从 编程 的 角度 开始 ， 即 
从 Arduino 和 树 短 派 等 价 件 友好 的 板 卡 开始 ， 然 后 
通过 为 这 些 板 卡 搭建 传 感 医 和 致 动 磺 来 了 解 电路 。 
两 种 方法 都 很 好 ， 大 多 数 时 候 你 可 能 会 发 现 自己 处 
于 两 者 之 间 。 


预 祝 你 在 电子 工程 方面 取得 巨大 成 功 。 一 旦 你 
创建 了 茶 个 作品 ， 我 希望 你 花 时 间 记 录 下 来 ， 并 与 
HAIE. TE 
Instructables Chttp://www.instructables.com/) 这 样 的 
网 站 上 ， 可 以 分 至 你 的 项 目 ， 或 从 全 球 其 他 人 的 
DIY 项 目 中 寻找 灵感 。 











ul] 关于 电子 学 的 全 而 参考 ， 我 推荐 Paul Scherz 
Simon Monk 的 《Practical Electronics for Inventors) 
第 3 版 (McGraw-Hill, 2013) . 


[2] CadSoft EAGLE PCB 设 计 软 
件 ， http://www.cadsoftusa.com/eagle-pcb-design- 


software/. 


[3] KiCad EDA 软 件 套件 ，http://www.kicad- 
pcb.org/display/KICAD/KiCad+EDA+Software+Suite/ 
[4] Jeremy Blum, “Tutorial 1 for Eagle: Schematic 


Design”, YouTube 〈2012 年 6 月 14 日 ) https: // 
www.youtube.com/watch?v=1 AXwjZoyNno。 


[5] 在 家 里 制作 PCB 的 一 些 技 术 可 以 在 
https://embeddedinn.wordpress.com/tutorials/home- 
made-sigle-sided-pcbs/ 找 到 。 


[6] Akash Patel, “Generating Gerber files from 
EAGLE", YouTube 〈2010 年 4 月 7 日 ) ， 
https://www.youtube.com/watch?v-B SbQeF83XU. 


[7] https://oshpark.com/. 


[8] 对 于 2D 软 件 ， 请 参阅 
Inkscape, http://www.inkscape.org/en/. 
[9] 对 于 3D 软 件 ， 请 参阅 


SketchUp, http://www.sketchup.com/. 


[10] Rich Decibels, “Laser-Cut Project Box 
Tutorial, "Ponoko (2011 年 8 月 9 日 〉， 
http://support.ponoko.com/entries/20344437-Laser- 
cut-project-box-tutorial/。 
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程 才 能 开始 使 用 它 。 在 该 项 目 中 ， 我 介绍 了 基本 设 
置 ， 但 这 里 有 一 些 额外 的 建议 和 技巧 ， 为 项 目 准 备 
BY FE o 





C.1 设置 Wi-Fi 


在 第 14 间 中， 我 建议 使 用 内 置 的 Wi-Fi 配 置 实 
用 程序 ， 在 树 每 派 上 设置 Wi-Fi。 但 利用 命令 行 ， 
可 以 更 快 地 做 同样 的 事 。 首 先 ， 在 终端 中 输入 以 下 
内 容 ， 在 nano 编 辑 器 中 显示 配置 文件 : 





$ sudo nano /etc/wpa supplicant/wpa supplicant.conf 


我 的 文件 看 起 来 像 这 样 : 


ctrl interface-DIR-/var/run/wpa supplicant GROUP=netdev 
update config-1 


network={ 
ssid=your-WiFi-network-name 
psk=your-password 
proto=RSN 
key_mgmt=WPA-PSK 
pairwise=TKIP 
auth alg-OPEN 


编辑 文件 的 内 容 ， 设 置 ssid 和 psk 以 符合 你 的 
Wi-Fi 设 置 。 如 果 缺 少 整个 network 部 分 ， 请 输入 设 
置 (填写 与 你 自己 的 Wi-Fi 设 置 相符 的 详细 信 
息 ) 。 


C.2 MAM AIRE A OER 


可 以 用 男 一 台 计 算 机 的 ping 命 令 ， 检查 树 每 派 
是 人 否 连接 到 本 地 网 络 。 下 面 是 ping 会 话 看 起 来 的 样 
了 


$ ping 192.168.4.32 

PING 192.168.4.32 (192.168.4.32): 56 data bytes 

64 bytes from 192.168.4.32: icmp seq-0 ttl-64 time-13.677 ms 
64 bytes from 192.168.4.32: icmp_seq=1 ttl-64 time-8.277 ms 
64 bytes from 192.168.4.32: icmp seq-2 ttl-64 time-9.313 ms 
--snip-- 


这 个 ping 的 输出 显示 了 发 送 的 字 市 数 和 获取 应 
答 所 花费 的 时 间 。 如 果 你 看 到 消 忠 “Request 
timeout...” MATERN EUR AR IEE $e Fl] PY 





C.3 防止 Wi-EFi 适 配器 进入 睡眠 状 
pos 


JON 


如 果 在 一 段 时 间 后 无 法 ping 通 树 侮 派 或 用 SHH 
连接 ， 你 的 USB ”Wi-EFi 适 配器 可 能 已 进入 睡眠 状 
态 。 可 以 通过 禁用 电源 管理 来 防止 这 种 情况 发 生 。 
首先 ， 使 用 下 面 的 命令 打开 控制 电源 管理 的 文件 : 





$ sudo nano /etc/modprobe.d/8192cu.conf 


然后 将 以 下 内 容 添 加 到 该 文件 中 : 


# disable power management 
options 8192cu rtw power mgnt-O 





重新 启动 树 莓 派 ，Wi-Fi 适 配器 现在 应 该 一 直 
保持 工作 。 


C.4 从 树 登 派 备 份 代码 和 数据 





当 你 在 树 每 派 上 放置 越 来 越 多 的 代码 时 ， 需 要 
一 种 备份 文件 的 方法 。rsync 是 一 个 了 不 起 的 工具 ， 
它 可 以 同步 两 个 文件 夹 之 则 的 文件 ， 即 使 它们 存在 
于 网 络 上 的 不 同 机 器 上 。rsync 非 常 强大 ， 所 以 不 要 
乱 动 它 ， 除 非 很 小 心 ， 人 否则 可 能 会 导致 删除 原始 文 
件 。 如 果 你 是 第 一 次 用 它 ， 请 首先 备份 你 的 测试 文 
件 ， 并 使 用 -n 标 志 “ 或 者 叫 “ 彩 排 ?) 。 这 样 ，rsync 
只 告诉 你 它 会 做 什么 ， 而 不 实际 做 ， 这 样 你 有 机 会 
熟悉 该 程序 ， 不 会 意外 删除 任何 东西 。 下 面 是 我 的 
FAAS, MAIER (递归 地 ) 备份 代码 目录 到 运行 OS 








#!/bin/bash 
echo Backing up RPi WM... 


# set this to Raspberry Pi IP address 
PI ADDR-'"192.168.4.31" 


# set this to the Raspberry Pi code directory 
# note that the trailing slash (/) is important with rsync 
PI DIR-"code/" 


# set this to the local code (backup) directory 
BKUP_DIR="/Users/mahesh/code/rpi1/" 


# run rsync 

# use this first to test: 

# rsync -uvrn pi@$PI_ADDR:$PI_DIR $BKUP_DIR 
rsync -uvr pi@$PI_ADDR:$PI_DIR $BKUP_DIR 


echo ... 
echo done. 


# play sound (for OS X only) 
afplay /System/Library/Sounds/Basso.aiff 


请 修改 这 段 代 码 ， 以 符合 你 的 目录 。 对 于 
Linux 和 OS X 用 户 ，rsync 已 内 置 。Windows 用 户 可 
以 尝试 grsyncl。 


C.5 d) SEI PU REUKERTE BT 





备份 树 每 派 上 的 操作 系统 是 一 个 好 主意 。 这 
样 ， 如 果 由 于 不 正常 天 机 导致 SD 卡 上 的 文件 系统 损 
坏 ， 你 可 以 快速 地 将 操作 系统 重 写 到 SD 卡 ， 而 无 需 
重新 完成 整个 设置 。 你 还 可 以 利用 备份 将 现 有 安装 
克隆 到 男 一 个 树 每 派 上 。StackExchange 上 发 布 的 一 
个 解决 方案 内 介绍 了 在 Linux 和 OS ” 义 上 使 用 dd 工 
具 ， 或 在 Windows 上 使 用 Win32 Disk Imager 软 件 。 








C.6 ”利用 SSH 登 录 到 树 莓 派 


在 第 14 章 中 ， 我 讨论 了 如 何方 便 地 利用 SSH 登 
录 到 树 每 派 并 工作 。 如 果 你 不 仪 频繁 地 这 样 做 ， 而 
用 是 用 同一 侣 计算机， 可 能 会 觉得 每 次 输入 密 但 很 
烦人 。 使 用 SSH 附 带 的 ssh-keygen 实 用 程序 ， 你 可 
以 设置 公共 /私有 密 钥 方案 ， 以 便 安 全 地 登录 到 树 每 
派 ， 而 无 需 输入 密码 。 对 于 OS X 和 Linux 用 户 ， 请 
按照 下 列 步骤 操作 〈 对 于 Windows 用 户 ，PuTTY 人 多 
许 你 进行 类 似 操作 中) 。 在 计算 机 的 终端 窗口 输入 
以 下 内 容 ， 根 据 需 要 修改 树 每 派 的 IP 地 址 : 








$ ssh-keygen 

Generating public/private rsa key pair. 

Enter file in which to save the key (/Users/xxx/.ssh/id rsa): 
Enter passphrase (empty for no passphrase): 

Enter same passphrase again: 

Your identification has been saved in /Users/xxx/.ssh/id rsa. 
Your public key has been saved in /Users/xxx/.ssh/id rsa.pub. 
The key fingerprint is: 

--snip-- 


HE, BEAMER BY EK : 


$ scp -/.ssh/id rsa.pub pi@192.168.4.32:.ssh/ 

The authenticity of host '192.168.4.32 (192.168.4.32)' can't 
RSA key fingerprint is f1:ab:07:e7:dc:2e:f1:37:1b:6f:9b:66:85 
Are you sure you want to continue connecting (yes/no)? yes 


Warning: Permanently added '192.168.4.32' (RSA) to the list o 
pi@192.168.4.32's password: 

id rsa.pub 100% 398 
0.4KB/s 00:00 


PRI, REM REIR: 


$ ssh pi@192.168.4.32 
pi@192.168.4.32's password: 


$ cd .ssh 

$ 1s 

id_rsa.pub known_hosts 

$ cat id_rsa.pub >> authorized_keys 
$ 1s 


authorized_keys id_rsa.pub known_hosts 
$ logout 


下 次 登录 树 每 派 时 ， 系 统 不 会 要 求 你 输入 密 
人 码 。 男 外 ， 请 注意 ， 我 在 ssh-keygen 中 使 用 一 个 空 
窗 个 ， 这 是 不 安全 的 。 这 个 设置 可 能 适用 于 树 每 派 
便 件 项 目 ， 这 里 你 不 太 在 意 安 全 性 ， 但 有 关 使 用 
SSH 和 密码 的 进一步 讨论 ， 请 参阅 “Working with SSH 
Key Passphrases”"， 这 是 一 篇 有 用 的 GitHub 文 章 生 ，。 





C.7 (EHP RERIN. 


如 果 你 想 用 树 每 派 拍摄 照片 ， 有 一 个 专用 的 相 

机 模块 名。 该 模块 有 一 个 固定 焦距 和 景深 的 相机 ， 
相机 支持 图 像 记 录 〈(5 百 万 像素 ) 和 视频 记录 

《1080 像 素 在 30 帧 / 秒 ) 。 它 通过 带 状 电 绑 连接 到 树 
每 派 。 安 装 相 机 模块 后 ， 可 以 使 用 raspistill 命 令 扫 
摄 照 搬 或 视频 。 请 确保 在 首次 局 动 树 每 派 时 启用 相 
机 支持 。 在 安装 摄像 机 之 前 ， 请 查看 安装 视频 器 。 
这 段 视频 还 介绍 了 如 何 使 用 raspistil 命 令 。 包 








C.8 (cB AK LA APS 


树 侮 派 带 有 一 个 音频 输出 插 孔 。 如 果 你 无 法 在 
树 蔡 派 上 听 到 任何 声音 ， 可 能 需要 安装 ALSA 工 
H. CAGE Web Design 的 一 个 资料 页 面 介绍 了 它 的 
4M, 


C.9 MEIKE 





Peewee LIER LEE, whe WERTE 
了 。 首 先 ， 需 要 安装 pyttsx， 这 是 一 个 Python 文 本 转 
语音 的 库 创 。 像 下 面 这 样 安装 它 : 





$ wget https://pypi.python.org/packages/source/p/pyttsx/pytts 


$ gunzip pyttsx-1.1.tar.gz 

$ tar -xf pyttsx-1.1.tar 

$ cd pyttsx-1.1/ 

$ sudo python setup.py install 


然后 需要 安装 espeak， 如 下 所 示 : 


fA 


sudo apt-get install espeak 


MERE a Ee BEING 
行 以 下 代码 : 





import sy: 
import pyttsx 


# main() function 

def main(): 
# use sys.argv if needed 
print 'running speech-test.py...' 
engine - pyttsx.init() 


str = "I speak. Therefore. I am. " 
if len(sys.argv) » 1: 

str = sys.argv[1] 
engine.say(str) 
engine.runAndWait() 


# call main 
if name == ' main ': 
main() 


C.10 让 HDMI 工 作 


你 可 以 用 HDMI 电 顷 将 树 每 派 连 上 显示 茵 或 电 
视 机 。 为 了 确保 它 在 第 一 次 启动 树 每 派 时 工作 ， 请 
在 计算 机 中 打开 树 每 派 的 SD 卡 ， 并 在 顶层 目录 中 编 
辑 config.txt， 如 下 所 示 : 








hdmi_force_hotplug=1 


现在 ， 如 果树 莹 派 启 动 ， 你 应 该 能 够 通过 
HDMI 看 到 输出 。 


CA1 ik AER 


ihe n] OLEN REYRE HI He i as. (EA EEE 
fe, TRA) Be AS BLL AERA, MA WRADUT] FE 
线 。 为 此 ， 你 需要 一 个 电池 组 。 一 个 效果 很 好 的 选 
项 是 带 有 兼容 micro USB 输 出 的 可 充电 电池 组 。 我 
用 Anker Astro Mini 3000mAh 外 部 电池 取得 了 很 好 
的 效果 ， 这 可 以 在 网 上 找到 ， 约 20 美 元 。 





C.12 JH PARKER TTE hl A 


A FEU RR 你 可 以 登录 a 到 树 每 派 并 在 
终 闹 中 输入 以 下 命令 ， 检 查 树 王 派 的 便 件 版 本 : 


$ cat /proc/cpuinfo 


下 面 是 我 的 终 顺 上 的 输出 : 


processor : 0 

model name : ARMv6-compatible processor rev 7 (v61) 
BogoMIPS : 2.00 

Features : swp half thumb fastmult vfp edsp java tls 
CPU implementer : 0x41 

CPU architecture: 7 

CPU variant : 0x0 

CPU part : 0Oxb76 

CPU revision : 7 


Hardware : BCM2708 


Revision : 000f 
Serial : 00000000364a6fic 


要 了 解 修 订 版 本 号 (revision) ， 请 参阅 
http:Welinux.org/RPi_HardwareHistory 上 的 硬件 修订 
历史 记录 表 。 在 我 的 例子 中 ， 是 2012 年 第 4 季度 制 
作 的 PCB 版 本 2.0 的 B 型 。 





[你 可 以 从 http://grsync-win.sourceforge.net/ 下 载 
grsync - H T Windowsllrsync?im I. 


[2] 你 可 以 在 Stack Exchange EFR $1 4 (0M REYR RISD 
卡 的 说 明 。“How do I backup my Raspberry Pi?”, 
Stack Exchange, 
http://raspberrypi.stackexchange.com/questions/311/ho 
do-i-backup-my-raspberry-pi/. 


[3] “How to Create SSH Keys with PuTTY to Connect 
to a VPS”, DigitalOcean (20134F7 H 19 
H2 , https://www.digitalocean.com/ 
community/tutorials/how-to-create-ssh-keys-with - 
putty-to-connect-to-a-vps /。 


[4] “Working with SSH Key Passphrases", GitHub7j 
HJ, https://help.github.com/articles/working-with-ssh- 
key-passphrases/. 


ES] 请 参阅 树 每 派 相机 模块 的 产品 页 面 ， 网 址 
为 http://www.raspberrypi.org/product/camera- 


module/. 





[6] The RaspberryPiGuy, “Raspberry Pi-Camera 
Tutorial, "YouTube (20134F54H 26H) , https: // 
www.youtube.com/watch?v=T8T6S5eFpqE > 


[7] “Raspberry Pi—Getting Audio Working”, CAGE 


Web Design 〈2013 年 2 月 9 日 ) http: // 
cagewebdev.com/index.php/ raspberry-pi-getting- 
audio-working/. 


[8] 你 可 以 在 https:// github.com/parente/pyttsx/1K £! 
pyttsx 的 GitHub 库 ， 这 是 一 个 Python 文本 转 语音 的 
FEE 


欢迎 来 到 异步 社区 ! 


异步 社区 的 来 历 


异步 社区 (www.epubit.com.cn) 是 人 民 邮 电 出 版 
社 旗 下 IT 专业 图 书 旗舰 社区 ， 于 2015 年 8 月 上 线 运 


异步 社区 依托 于 人 民 邮 电 出 厂 社 20 余 年 的 IT 专 
业 优 质 出 版 资源 和 编辑 策划 团队 ， 打 造 传统 出 版 与 
电子 出 版 和 自 出 版 结合 、 纸 质 书 与 电子 书 结合 、 传 
统 印刷 与 POD 按 需 印 刷 结合 的 出 版 平台 ， 近 供 了 最 新 
技术 资讯 ， 为 作者 和 读者 打造 交流 互动 的 平台 。 
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我 要 写 书 -— 
Write for Us ume 
Python 机 器 学 习 一 一 预 — 贝 叶 斯 方法 ; SERR — 机 器 学 习 项 目 开发 实战 MER: 统计 建 模 


列 分 析 核 心 纂 法 与 贝 叶 斯 推 基 的 python 学 习 法 近期 活动 
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AK BAA TTA? 


购 头 图书 


我 们 出 版 的 图 书 涵盖 主流 IT 技 术 ， 在 编程 语 
言 、Web 技 术 、 数 据 科 学 等 领域 有 众多 经 典 畅销 图 
书 。 社 区 现 已 上 线 图 书 1000 余 种 ， 电 子 书 400 多 
种 ， 部 分 新 书 实现 纸 书 、 电 子 书 同步 出 版 。 我 们 还 
会 定期 发 布 新 书 书 讯 。 

下 载 资 源 

社区 内 提供 随 书 附 赠 的 资源 ， 如 书 中 的 案例 或 
程序 源 代 人 码 。 

另外 ， 社 区 还 提供 了 大 量 的 免费 电子 书 ， 只 要 
注册 成 为 社区 用 户 就 可 以 免费 下 载 。 

与 作 译 者 互动 

很 多 图 书 的 作 译 者 已 经 入 驻 社 区 ， 您 可 以 关注 
人 他们， 咨询 技术 问题 ， 可 以 阅读 不 断 更 新 的 技术 文 
章 ， 听 作 译 者 和 编辑 畅 聊 好 书 背后 有 趣 的 故事 : 还 
可 以 参与 社区 的 作者 访谈 栏目 ， 回 您 关注 的 作者 提 
出 采访 题目 。 








灵活 优惠 的 购书 


您 可 以 方便 地 下 单 购买 纸 质 图 书 或 电子 图 书 ， 
纸 质 图 书 直 接 从 人 民 邮 电 出 版 社 书库 发 贷 ， 电 子 书 
提供 多 种 阅读 格式 。 

对 于 重 磅 新 书 ， 社 区 提供 预 售 和 新 书 首 发 服 
务 ， 用 户 可 以 第 一 时 间 买 到 心仪 的 新 书 。 

用 户 帐 户 中 的 积分 可 以 用 于 购书 优惠 。100 积 
分 =1 元 ， 购 买 图 书 时 ， 在 。 : 里 填 入 可 使 用 的 
积分 数值 ， 即 可 扣 减 相应 金额 。 
EIE 

购买 本 电子 书 的 读者 专 享 异步 社区 优惠 券 。 "使 用 方法 ,注册 


成 为 社区 用 户 ， 在 下 单 购书 时 输入 “57AWG”， 然 后 点 击 “ 使 用 优惠 
码 ”， 即 可 宇 受 电子 书 8 折 优 惠 〈 本 优惠 券 只 可 使 用 一 次 ) 。 


纸 电 图 书 组 合 购买 


社区 独家 提供 纸 质 图 书 和 电子 书 组 合 购 买方 
陈 ， 价 格 优惠 ， 一 次 购买 ， 多 种 阅读 选择 。 
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Wireshark 网 络 分 析 的 艺术 
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Wireshark 是 当前 最 流行 的 网 络 包 分 析 工 具 。 它 上 手 简单 ARENA), $$ 
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提交 勘误 

您 可 以 在 图 书页 面 下 方 提 交 勘 误 ， 每 条 勘误 被 
确认 后 可 以 获得 100 积 分 。 热 心 勘 误 的 读者 还 有 机 
会 参与 书稿 的 审 校 和 翻译 工作 。 
EE 

社区 提供 基于 Markdown 的 写作 环境 ， 喜 欢 写 
作 的 您 可 以 在 此 一 斌 身手 ， 在 社区 里 分 享 您 的 技术 
心得 和 读书 体会 ， 更 可 以 体验 目 出 版 的 乐趣 ， 轻 松 
实现 出 版 的 梦想 。 

如 果 成 为 社区 认证 作 译 者 ， 还 可 以 享受 异步 社 
区 提供 的 作者 专 享 特色 服务 。 
会 议 活 动 早 知道 

您 可 以 掌握 IT 圈 的 技术 会 议 资讯 ， 更 有 机 会 免 
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加 入 异步 


扫描 任意 二 维 码 都 能 找到 我 们 : 


:RE 





异步 社区 





微 信服 务 号 











官方 微 博 





QQ 和 群 : 436746675 


社区 网 址 : www.epubit.com.cn> 





官方 微 博 : @ 人 邮 异 步 社 区 ，@ 人 民 邮 电 出 版 
社 -信息 技术 分 社 


FS Ain Sc ‘ZF Vi]: contact@epubit.com.cn 
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